home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / udbsv541.zip / UDBS.DOC < prev    next >
Text File  |  1992-05-12  |  119KB  |  2,810 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                             The User Database System
  30.                                    Version 5.41
  31.                                     May 1992
  32.  
  33.                                 For PCBoard 14.5a
  34.  
  35.                                  Operators Guide
  36.  
  37.                         Copyright (C) Jeff Sumberg, 1987 - 1992
  38.  
  39.  
  40.  
  41.  
  42.  
  43.                                 Table Of Contents
  44.  
  45.      The User Database System  . . . . . . . . . . . . . . . . . . . .    5
  46.  
  47.      Registration  . . . . . . . . . . . . . . . . . . . . . . . . . .    5
  48.  
  49.      Copying and Distribution  . . . . . . . . . . . . . . . . . . . .    6
  50.  
  51.      Distribution Contents . . . . . . . . . . . . . . . . . . . . . .    6
  52.  
  53.      System Requirements . . . . . . . . . . . . . . . . . . . . . . .    7
  54.  
  55.      Operational Restrictions  . . . . . . . . . . . . . . . . . . . .    8
  56.  
  57.      Configuration . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  58.           INPUT= . . . . . . . . . . . . . . . . . . . . . . . . . . .    9
  59.           OUTPUT=  . . . . . . . . . . . . . . . . . . . . . . . . . .   10
  60.           UPDATE=YES . . . . . . . . . . . . . . . . . . . . . . . . .   10
  61.           USEACTBACKUP=NO  . . . . . . . . . . . . . . . . . . . . . .   11
  62.           PURIFYBACKUP=NO  . . . . . . . . . . . . . . . . . . . . . .   11
  63.           FILES= . . . . . . . . . . . . . . . . . . . . . . . . . . .   11
  64.           NEW=YES  . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  65.           USERS= . . . . . . . . . . . . . . . . . . . . . . . . . . .   12
  66.           PCBNDX=  . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  67.           NEWADDITIONS=NO  . . . . . . . . . . . . . . . . . . . . . .   13
  68.           MBQ= . . . . . . . . . . . . . . . . . . . . . . . . . . . .   13
  69.           BULLETINx= . . . . . . . . . . . . . . . . . . . . . . . . .   13
  70.           VERSION= . . . . . . . . . . . . . . . . . . . . . . . . . .   14
  71.           SINGLENODE . . . . . . . . . . . . . . . . . . . . . . . . .   15
  72.           LOG= . . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  73.           EVENT  . . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  74.           REPORT=  . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  75.           COLOR=NO . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  76.           DOS PATH . . . . . . . . . . . . . . . . . . . . . . . . . .   16
  77.  
  78.      Text and Language Configuration . . . . . . . . . . . . . . . . .   18
  79.           Languages= . . . . . . . . . . . . . . . . . . . . . . . . .   18
  80.           LanguageX= . . . . . . . . . . . . . . . . . . . . . . . . .   18
  81.           Language File Format . . . . . . . . . . . . . . . . . . . .   19
  82.           Text Matching Rules  . . . . . . . . . . . . . . . . . . . .   20
  83.  
  84.      Program Operation - Useact  . . . . . . . . . . . . . . . . . . .   22
  85.           Storage Available  . . . . . . . . . . . . . . . . . . . . .   22
  86.           Running Useact In Event.Sys  . . . . . . . . . . . . . . . .   22
  87.           Error Handling In Useact . . . . . . . . . . . . . . . . . .   22
  88.           Useact's Command line mode . . . . . . . . . . . . . . . . .   23
  89.  
  90.      Program Operation - Query . . . . . . . . . . . . . . . . . . . .   24
  91.           User Statistics  . . . . . . . . . . . . . . . . . . . . . .   24
  92.           Users Who Never Download . . . . . . . . . . . . . . . . . .   24
  93.           Users Who Never Upload . . . . . . . . . . . . . . . . . . .   24
  94.           File Transfers During a Specific Period  . . . . . . . . . .   25
  95.  
  96.      UDBS Version 5.41                                               Page 2
  97.  
  98.  
  99.  
  100.  
  101.  
  102.           Users With Keyboard Timeout Disconnects  . . . . . . . . . .   25
  103.           Users Disconnected For Daily Time Limit  . . . . . . . . . .   25
  104.           Users That Downloaded A Specific File  . . . . . . . . . . .   25
  105.           Who Uploaded A Specific File . . . . . . . . . . . . . . . .   25
  106.           All Files Downloaded By A Specific User  . . . . . . . . . .   25
  107.           All Files Uploaded By A Specific User  . . . . . . . . . . .   25
  108.           Display Period Totals  . . . . . . . . . . . . . . . . . . .   26
  109.           Users Exceeding DL/UL Ratio  . . . . . . . . . . . . . . . .   26
  110.           Users That Never Left A Message  . . . . . . . . . . . . . .   26
  111.           Doors and Node Chat  . . . . . . . . . . . . . . . . . . . .   26
  112.           Users With Security Violations . . . . . . . . . . . . . . .   27
  113.           Baud Rates and Protocols . . . . . . . . . . . . . . . . . .   28
  114.           Users That Page Sysop  . . . . . . . . . . . . . . . . . . .   28
  115.           Show New Users On Specified Date . . . . . . . . . . . . . .   28
  116.           Scan For User Name . . . . . . . . . . . . . . . . . . . . .   28
  117.           Generate Reports . . . . . . . . . . . . . . . . . . . . . .   28
  118.  
  119.      File Maintenance Functions  . . . . . . . . . . . . . . . . . . .   29
  120.           Delete User  . . . . . . . . . . . . . . . . . . . . . . . .   29
  121.           Delete If Not In User File . . . . . . . . . . . . . . . . .   29
  122.           Purify Files . . . . . . . . . . . . . . . . . . . . . . . .   29
  123.           Undelete User  . . . . . . . . . . . . . . . . . . . . . . .   30
  124.           Add Download Credit  . . . . . . . . . . . . . . . . . . . .   31
  125.           Add Upload Credit  . . . . . . . . . . . . . . . . . . . . .   31
  126.           Delete Download Credit . . . . . . . . . . . . . . . . . . .   31
  127.           Delete Upload Credit . . . . . . . . . . . . . . . . . . . .   31
  128.           Database Size Information  . . . . . . . . . . . . . . . . .   31
  129.           Change User Name . . . . . . . . . . . . . . . . . . . . . .   31
  130.           Subscriptions  . . . . . . . . . . . . . . . . . . . . . . .   32
  131.           Comments . . . . . . . . . . . . . . . . . . . . . . . . . .   32
  132.           Rebuild Index Files  . . . . . . . . . . . . . . . . . . . .   33
  133.           Reset Bulletin Flag  . . . . . . . . . . . . . . . . . . . .   33
  134.           Merge Two Data Records . . . . . . . . . . . . . . . . . . .   34
  135.  
  136.      Problems & Support  . . . . . . . . . . . . . . . . . . . . . . .   35
  137.  
  138.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .   35
  139.  
  140.      Disclaimer/Warranty . . . . . . . . . . . . . . . . . . . . . . .   36
  141.  
  142.      Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . .   36
  143.  
  144.      Appendix A - Getting Your Database Started  . . . . . . . . . . .   37
  145.  
  146.      Appendix B - The NewCalls Utility Program . . . . . . . . . . . .   38
  147.  
  148.      Appendix C - Setup For Multiple Node Systems  . . . . . . . . . .   40
  149.  
  150.      Appendix D - The Sync Utility . . . . . . . . . . . . . . . . . .   42
  151.  
  152.      Appendix E - Common Problems  . . . . . . . . . . . . . . . . . .   43
  153.  
  154.  
  155.      UDBS Version 5.41                                               Page 3
  156.  
  157.  
  158.  
  159.  
  160.  
  161.      Appendix F - What Registered Users Get  . . . . . . . . . . . . .   45
  162.  
  163.      Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   46
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.      UDBS Version 5.41                                               Page 4
  215.  
  216.  
  217.  
  218.  
  219.  
  220.                             The User Database System
  221.  
  222.      This collection of programs will enable you, the Sysop, to better
  223.      manage and monitor the activity of your users. The User Database
  224.      System brings together a call analyzer, a database, and a menu driven
  225.      query system that puts important user information at your disposal.
  226.      Immediately. All information on users is obtained from the CALLER file
  227.      generated by PCBoard. The major difference between the User Database
  228.      System and a standard call analyzer is that the User Database System
  229.      generates statistics on an individual user basis. 
  230.  
  231.      Some of the operations and features of the User Database System in-
  232.      clude:
  233.  
  234.           * View a users statistics
  235.           * View all files downloaded (or uploaded) by a user
  236.           * View all users that downloaded a specific file
  237.           * Find users exceeding UL/DL ratios
  238.           * Generate reports for posting in bulletins
  239.           * Fully text configurable and language independent
  240.           * Door programs and utilities for registered users
  241.           * And much more
  242.  
  243.  
  244.                               Program Registration
  245.  
  246.      The User Database System is not public domain, and it is not free
  247.      software, it is user supported. Non-registered users are given a
  248.      reasonable period of time (30 days) to try the programs out and
  249.      determine if they meets their needs, after this period you must
  250.      register your copy or discontinue its use. If these programs are used
  251.      in a commercial environment, then you must register it. Registration
  252.      of the User Database System is $25.00. User registrations are what
  253.      keeps this program going. This program was developed because of a
  254.      "need to know" situation. It represents many months of work, and
  255.      thousands of lines of code. I hope that you will find this program
  256.      useful in the management of your bulletin board system.  Remember,
  257.      only you, the end user, can make the Shareware concept work. Please
  258.      register your copy!
  259.  
  260.      Please fill out the registration form in REGISTER.FRM and send it with
  261.      your payment to:
  262.  
  263.                                   Jeff Sumberg
  264.                                     Box 212 
  265.                               Ringwood, N.J. 07456
  266.  
  267.      After you have registered, I will send you two Door programs and a
  268.      variety of utility programs that enhance the use of this database
  269.      system. Please see Appendix F for a description of these programs.
  270.  
  271.  
  272.  
  273.      UDBS Version 5.41                                               Page 5
  274.  
  275.  
  276.  
  277.  
  278.  
  279.      Registered users get support via the SailBoard BBS. When you register
  280.      with me be sure to include the name of your system EXACTLY
  281.      (upper/lower case) as you would like it to appear in the door pro-
  282.      grams, this name is hard coded and cannot be changed at your end. Also
  283.      I will automatically register you as a visiting Sysop and UDBS user on
  284.      the SailBoard BBS, so please send me the password that you would like
  285.      to use.
  286.  
  287.                             Copying and Distribution
  288.  
  289.      The User Database System is a copyrighted program that is being dis-
  290.      tributed as user supported software. It may be copied and distributed
  291.      freely as long as all terms of the license are followed. All files (as
  292.      mentioned here in the manual) must be included as a set. No fee other
  293.      than a disk and handling charge (of up to $5.00) may be charged.
  294.  
  295.                               Distribution Contents
  296.  
  297.      USEACT.EXE     The call analyzer
  298.      ENGLISH.UDB    Standard english language text scan list
  299.      QUERY.EXE      The database query program
  300.      MODIFY.EXE     The file maintenance functions for Query
  301.      SYNC.EXE       Utility to Synchronize database to Users file
  302.      NEWCALLS.EXE   Utility to facilitate daily database updates
  303.      UDBS.CFG       Sample configuration file
  304.      UDBS50.EXE     A custom Basic Compiler run-time library
  305.      UDBS.DOC       This file
  306.      READ.ME        If included, contains important information about this
  307.                     release. It should be read FIRST before doing anything
  308.                     else. Any additional files in the distribution will be
  309.                     explained here.
  310.  
  311.      USEACT.EXE     This is the analyzer program. This program reads the
  312.                     caller log and separates all the activities of each
  313.                     user. The results of which are optionally written to a
  314.                     report file and/or optionally written to the database.
  315.                     In this way, reports can be generated at any time
  316.                     without affecting the database (or Visa-Versa).
  317.  
  318.      ENGLISH.UDB    This file contains all the items that are scanned for
  319.                     by the Useact program. These are the standard entries
  320.                     from the stock PCBTEXT file. If you customize PCBTEXT,
  321.                     then you change the respective lines in this file. See
  322.                     section on Text/Language configuration.
  323.  
  324.      QUERY.EXE      This program is used to examine the information stored
  325.                     in the database. 
  326.  
  327.      MODIFY.EXE     This program contains all the file maintenance func-
  328.                     tions of Query. (This program is chained to by Que-
  329.                     ry.Exe and is not intended to be run from the command
  330.                     line).
  331.  
  332.      UDBS Version 5.41                                               Page 6
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.      SYNC.EXE       This utility is used to synchronize the Upload, Downlo-
  340.                     ad, and Times On System values to correspond with the
  341.                     values already in you system Users file. This program
  342.                     can be run interactively or in a batch mode
  343.                     (Event.Sys). For more information see Appendix D.
  344.  
  345.      NEWCALLS.EXE   This utility is used to facilitate daily database
  346.                     updates during your event. This programs 'remembers'
  347.                     where the last place in the callers log was when the
  348.                     previous event ran and extracts all call records from
  349.                     that point on. Appendix B has more information.
  350.  
  351.      UDBS.CFG       This is a sample configuration file containing paramet-
  352.                     ers used to control all of the programs. The contents
  353.                     of this file are explained in detail in the chapter on
  354.                     configuration. You will probably have to customize this
  355.                     file to your system.
  356.  
  357.      UDBS50.EXE     This is custom Basic run-time library. It is required
  358.                     by ALL programs. This is NOT an executable program even
  359.                     though it bears the an EXE extension. Running it will
  360.                     only produce its version number. This file can be kept
  361.                     anywhere on your system on any drive, as long as it is
  362.                     within your current PATH specification at run-time. If
  363.                     this file cannot be found, you will receive a prompt
  364.                     asking for its location. Probably the best place to put
  365.                     it is in the same subdirectory as the programs.
  366.  
  367.  
  368.                                System Requirements
  369.  
  370.      These programs require a minimum 250k of memory to operate. The
  371.      programs all operate in text mode with or without color (color is
  372.      selected automatically if a color card is sensed and may be disabled
  373.      if desired). Therefore any type of monitor/display card combination is
  374.      acceptable. At one time or another, some of these programs will have
  375.      as many as 13 files open. Given the fact that Dos always has the first
  376.      five files open for the standard input and output devices, you will
  377.      need a Files= statement in your Config.Sys file (Of at least
  378.      Files=20). Dos version 3.x is also required for the file sharing
  379.      support. These programs have been tested on, and are being used with
  380.      DoubleDos, Taskview, Alloy's PC/slave card with NTNX, DESQview, and
  381.      Microsoft Windows on True PC's, XT's, AT's, PS/2's, 386 systems, and
  382.      various clones. I do not however guarantee that these program will
  383.      work under every conceivable hardware and software configuration, but
  384.      they seem to work fine under many different configurations on MANY
  385.      different systems.
  386.  
  387.  
  388.  
  389.  
  390.  
  391.      UDBS Version 5.41                                               Page 7
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.                             Operational Restrictions
  399.  
  400.                          !!!PLEASE READ THIS SECTION!!!
  401.  
  402.      THE PROGRAMS IN THIS RELEASE WERE DESIGNED TO OPERATE WITH PCBOARD
  403.      VERSION 14 AND PREVIOUS RELEASES (TO VERSION 10). USE OF THESE
  404.      PROGRAMS ON ANY FUTURE RELEASES MAY PRODUCE UNDESIRABLE OR UNPREDIC-
  405.      TABLE RESULTS, INCLUDING BUT NOT LIMITED TO, IRREVERSIBLE DATA FILE
  406.      DAMAGE. IF YOU PLAN TO USE THIS VERSION OF THE USER DATABASE SYSTEM ON
  407.      ANY FUTURE RELEASES OF PCBOARD, YOU SHOULD TAKE ADEQUATE STEPS TO
  408.      PROTECT YOUR DATA BEFORE YOU DO SO. A BACKUP OF ALL THE DATA FILES
  409.      SHOULD BE MADE BEFORE RUNNING ANY QUESTIONABLE CALLERS LOGS THROUGH
  410.      THESE PROGRAMS, THIS WAY YOU ARE PROTECTED AGAINST ANY UNFORESEEN
  411.      CHANGES IN PCBOARD NOT EXPECTED BY THESE PROGRAMS. THINGS YOU SHOULD
  412.      BE MOST AWARE OF AT EACH NEW RELEASE ARE CHANGES TO THE CALLERS LOG,
  413.      SINCE THIS IS WHERE ALL INFORMATION IS EXTRACTED FROM. IT TAKES SOME
  414.      TIME IN ORDER TO ANALYZE WHAT EFFECT ANY TYPE OF CHANGE WILL CREATE,
  415.      AND YOU SHOULD BE PREPARED IN THE EVENT THESE PROGRAMS FUNCTION
  416.      ABNORMALLY. 
  417.  
  418.      THESE PROGRAMS DO NOT, AND WILL NOT, SUPPORT ANY BETA RELEASES OF
  419.      PCBOARD THAT MAY BE AVAILABLE NOW, OR IN THE FUTURE. IF YOU PLAN TO
  420.      RUN THESE PROGRAMS WITH PCBOARD BETA SOFTWARE THAT MIGHT BE RELEASED,
  421.      YOU DO SO ENTIRELY AT YOUR OWN RISK.
  422.  
  423.      THE USE OF INDEXED FILES REQUIRES MORE CARE ON YOUR PART THAN WITH
  424.      PREVIOUS VERSIONS. DUE TO THE NATURE OF THESE FILES, THEY ARE MORE
  425.      SUBJECT TO DAMAGE THAN FILE STRUCTURES USED IN PREVIOUS VERSIONS.
  426.      UNDER NO CIRCUMSTANCES SHOULD THESE PROGRAMS BE TERMINATED IN A METHOD
  427.      OTHER THAN THAT PROVIDED FOR EXITING. 
  428.  
  429.      The new XRF files used a linked chain scheme similar to the FAT used
  430.      on disks. This is where the increased speed is realized by not reading
  431.      any records not associated by the user being queried. However, like
  432.      the FAT on a disk, once damaged, is impossible to repair. If for some
  433.      reason your computer should lock up, reboot, or loose power while
  434.      USEACT, MODIFY, or DOWNCRED/UPCRED is running and in the process of
  435.      MODIFYING files, there is a very good possibility that either your
  436.      data files or the index files will be damaged. Therefor you should
  437.      ALWAYS keep a current backup. Follow this rule of thumb: if the above
  438.      does happen (lockup/boot/power loss), ASSUME THE FILES TO BE DAMAGED,
  439.      and use your latest backup copy, bringing it up to date. Signs of
  440.      damaged chains are "Bad Record Number" or "Error 64", index file
  441.      damage may cause all sorts of odd operation. Under normal operating
  442.      conditions you should never see this, but it is your responsibility to
  443.      be prepared for it.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.      UDBS Version 5.41                                               Page 8
  451.  
  452.  
  453.  
  454.  
  455.  
  456.                                   Configuration
  457.  
  458.      All of these programs use a configuration file to set options and
  459.      locate files. This file, UDBS.CFG must be present in the current
  460.      directory(1) whenever one of the programs is run, or an error message
  461.      will be issued. Refer to the sample configuration file that came with
  462.      the distribution.
  463.  
  464.         IMPORTANT:   In the following examples, please notice that there is
  465.                      no space on either side of the equal (=) sign.
  466.                      Improper operation will result if spaces are used.
  467.  
  468.      INPUT=fname
  469.  
  470.           This line is used by Useact.Exe to specify the name of the
  471.           callers log. The INPUT= parameter is REQUIRED, and can only
  472.           specify ONE file. If you put more than one input statement in
  473.           your config file, only the last one will be used. Typical entries
  474.           might be:
  475.  
  476.              INPUT=CALLER
  477.              INPUT=CALLER1
  478.              INPUT=C:\PCB\MAIN\CALLERS
  479.  
  480.           If more than one log file needs to be processed, as is the case
  481.           in multiple node systems, their names may be supplied via an
  482.           indirect file. This is done by placing an '@' in front of the
  483.           filename:
  484.  
  485.              INPUT=@MYLOGS
  486.  
  487.           In this example, MYLOGS is a file that will contain the names of
  488.           the logs to process. Each line of MYLOGS will contain the name of
  489.           ONE log file (with any required paths). MYLOGS is a text file
  490.           with each line terminated in a CR/LF. MYLOGS should look like
  491.           this:
  492.  
  493.              [/path/]log1
  494.              [/path/]log2
  495.              [/path/]log3
  496.                 .
  497.                 .
  498.              [/path/]logn
  499.  
  500.           You can process as many log files as you like in this manner with
  501.           only one run of Useact. Note that MYLOGS is only an example name,
  502.           it can be any name you choose.
  503.  
  504.                                         ____________________
  505.  
  506.                1    There is an exception  to this rule. See "DOS  PATH" at
  507.                     the end of this section.
  508.  
  509.      UDBS Version 5.41                                               Page 9
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.      OUTPUT=fname
  517.  
  518.           The OUTPUT= parameter is optional. If supplied a detailed report
  519.           about the current Useact run will be generated. Typical usage:
  520.  
  521.              OUTPUT=OCT86.DAT
  522.              OUTPUT=CALLS
  523.              OUTPUT=D:\LOG\JAN1-86
  524.  
  525.           If an OUTPUT= statement is not placed into UDBS.CFG then NO
  526.           output log file will be generated.
  527.  
  528.      UPDATE=YES
  529.  
  530.           You can run USEACT.EXE with or without the database update
  531.           active. The only way to process a log into the database is by
  532.           setting this parameter to "YES" (The default is no database
  533.           generation). If any other value is used or the line is not
  534.           present in the configuration file, no update will occur. This is
  535.           useful for when you want to regenerate a log report that has
  536.           already been processed into the database.
  537.  
  538.           When update is set to "YES", thirteen (13) other files are used.
  539.           These are the actual database files. They are automatically
  540.           created the first time that update is used. These files are:
  541.  
  542.             DATABASE.DAT     This file contains individual user records. 
  543.  
  544.             MASTER.DAT       This file contains period totals. A period
  545.                              total is the cumulative amounts of each system
  546.                              function for a given update run. This is the
  547.                              same as the cumulative total screen shown at
  548.                              the end of a Useact run.
  549.  
  550.             DOWNLOAD.NAM     This file contains all the names of downloaded
  551.                              files
  552.  
  553.             DOWNLOAD.XRF     This file contains the cross reference links
  554.                              to tie a file name to a user.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.      UDBS Version 5.41                                              Page 10
  569.  
  570.  
  571.  
  572.  
  573.  
  574.             UPLOAD.NAM       Same as DOWNLOAD.NAM
  575.  
  576.             UPLOAD.XRF       Same as DOWNLOAD.XRF 
  577.  
  578.             COMMENTS.DAT     This file contains the comments you add.
  579.  
  580.             filename.HDR
  581.             filename.IDX     These are index files. There will be three
  582.                              different "filenames" corresponding to the
  583.                              files that are indexed.
  584.  
  585.           In addition, when you run an update, if the above files already
  586.           exist they are copied to backup files before processing starts
  587.           (See xBACKUP= parameters below). If an error occurs after one of
  588.           the primary files has been modified, Useact attempts to restore
  589.           the original files from the backup files. In any case, the backup
  590.           files are not deleted, and remain intact until Useact is
  591.           restarted with update set to yes, or a Purify operation is done
  592.           in Query. The backup filenames that are used are: DATABASE.BAK,
  593.           DOWNLOAD.BAK, UPLOAD.BAK, MASTER.BAK, DOWNLOAD.XBK, UPLOAD.XBK,
  594.           COMMENTS.BAK, *.HBK, & *.IBX. These files may be deleted at any
  595.           time if you need the space, if not I would leave them alone, as
  596.           they offer some sort of insurance should a problem occur. In any
  597.           event, make sure you keep you data files BACKED UP AT ALL TIMES!
  598.           These files are opened as "Access Read Write Lock Read Write". In
  599.           a network environment this prevents the doors from accessing the
  600.           files while Useact or Modify are using them. 
  601.  
  602.  
  603.      USEACTBACKUP=NO
  604.      PURIFYBACKUP=NO
  605.  
  606.           At the request of several users, who have extremely large
  607.           databases, I have included a way to inhibit the automatic copy of
  608.           the database files. The USEACTBACKUP=NO parameter inhibits backup
  609.           before Useact starts, and the PURIFYBACKUP=NO parameter inhibits
  610.           backup before Purify begins. Unless you keep a very concise
  611.           backup schedule and have the ability to go back to an earlier
  612.           copy if any problems are found (which these users do), I don't
  613.           recommend using either of these two parameters.
  614.  
  615.      FILES=pathname
  616.  
  617.           This parameter allows you to specify a path to the database
  618.           files. This allows you to keep the programs in one directory and
  619.           your database files in a completely separate directory. If this
  620.           line is not in the file then the database files will be looked
  621.           for in the current directory. Be sure to end your path specifi-
  622.           cation with a '\' (as in "Files=\DATA\") or an error will result.
  623.  
  624.  
  625.  
  626.  
  627.      UDBS Version 5.41                                              Page 11
  628.  
  629.  
  630.  
  631.  
  632.  
  633.      NEW=YES
  634.  
  635.           This parameter causes the report file generated by Useact to
  636.           contain an activity listing for new users ONLY. A new user is
  637.           determined from the log by the following two log entries:
  638.  
  639.              Refused to register
  640.              Registration information saved
  641.  
  642.           These log entries are determined by how a first time caller
  643.           responds to the question "Do you want to register?" after his/her
  644.           name was not found in the USERS file. A count is kept of registe-
  645.           red and unregistered users, and the users report entry shows
  646.           which state he/she is in. This parameter ONLY controls what is
  647.           written to the report file. If "new" is used in conjunction with
  648.           "update", ALL user activity is written to the database, but only
  649.           new users are written to the report. This was primarily intended
  650.           to be used without update to isolate all new users within a log
  651.           period.
  652.  
  653.      USERS=\Path\usersfilename
  654.  
  655.           This parameter is used to point to the subdirectory where your
  656.           PCBoard USERS file resides, and allows you to specify its name. 
  657.           Supply the full path to your users file, and INCLUDE the name of
  658.           your users file. In QUERY.EXE this is used for the "Delete if not
  659.           in users file" function. In USEACT.EXE this is used to screen new
  660.           users from being added to the database (see NEWADDITIONS=).
  661.  
  662.              Example: Users=\PCB\MAIN\USERS
  663.  
  664.           It is important to note that Clark Development may change the
  665.           format of this file at any time when they release a new version.
  666.           If this file changes, it will render the functions requiring the
  667.           users file inoperative. You should make it a point when you
  668.           receive a new version of PCBoard to check the chapter of the
  669.           documentation where the formats of PCBoard files are shown. If
  670.           the length given for the Users file has changed, then don't use
  671.           any functions requiring the Users file until you can obtain a
  672.           update of this system. I will try to stay on top of this situa-
  673.           tion and have any necessary corrections ready at the time of a
  674.           PCBoard update. The reason I mention this is so that you are
  675.           aware this condition. It would probably be a true statement to
  676.           say that as long as any PCBoard update does not require you to
  677.           run any type of 'conversion' program on your current Users file
  678.           that its format has not changed. To allow network operation, the
  679.           users file is opened as "Access Read Shared".
  680.  
  681.           If the current version setting is 12 or greater, then the PCBNDX
  682.           index files are used to locate user names (See PCBNDX=). Indexing
  683.           is cancelled automatically if a corrupted index file is detected.
  684.  
  685.  
  686.      UDBS Version 5.41                                              Page 12
  687.  
  688.  
  689.  
  690.  
  691.  
  692.           If this occurs the program stops using the index files and scans
  693.           the users file only in the same manner as the previous versions.
  694.  
  695.      PCBNDX=\path\to\pcbndx\files\
  696.  
  697.           This parameter is used to point the code to the location of your
  698.           PCBNDX.x user file index files. Starting with version 14 of
  699.           PCBoard, the location of these files is setable by the Sysop, and
  700.           do not necessarily need to reside in the same subdirectory as
  701.           your USERS file. This parameter allows you to exercise that
  702.           ability. Please note that this parameter MUST be set if you have
  703.           the USERS= parameter pointing to your users file otherwise your
  704.           index files can not be located. An error will be issued if not
  705.           properly set.
  706.  
  707.      NEWADDITIONS=NO
  708.  
  709.           As new users call your system, they are automatically added to
  710.           the database. For an open board there is no problem with this.
  711.           However, take the situation where a Sysop runs a 'closed' board.
  712.           In this situation new users cannot gain access to the system in
  713.           any meaningful way until the Sysop adds a record to the Users
  714.           file containing their information. What happens now is that
  715.           whenever a new users calls, even though he or she cannot gain
  716.           access to the system, the callers log still shows their call.
  717.           They get added to the database, and after a while the database
  718.           becomes full of names of people who aren't really users. To
  719.           prevent this from happening, include the line 'NEWADDITIONS=NO'
  720.           in the configuration file. When Useact processes user names, it
  721.           will first verify that they exist in your Users file. If they do
  722.           not, no database action will occur for that name. There is no
  723.           problem in having this set to 'no' at all times with any board.
  724.           This is because with an 'open' board all new users will be added
  725.           except those who don't register. You cannot use this option if
  726.           you are running version 10 of PCBoard, see the note under the
  727.           Version=10 parameter.
  728.  
  729.      MBQ=n
  730.  
  731.           If you require users to fill out a script questionnaire when they
  732.           log on for the first time, this function will record the date
  733.           that they do it. This date will be shown when you view the users
  734.           data record in Query. The value of 'n' should be the number of
  735.           the script questionnaire you wish to record. See page 19 for more
  736.           information on this.
  737.  
  738.      BULLETINx=y
  739.  
  740.           If you have bulletins which you require new users to read, this
  741.           is a way to monitor that. You can selectively monitor up to five
  742.           (5) of the bulletins on your system. In the parameter line you
  743.           will notice an 'x' and a 'y'. The 'x' is a number from 1 to 5
  744.  
  745.      UDBS Version 5.41                                              Page 13
  746.  
  747.  
  748.  
  749.  
  750.  
  751.           (for the five different bulletins to monitor), the 'y' is the
  752.           actual bulletin number on your system you wish to monitor. This
  753.           value can be from 1 to 99. Lets say you want to monitor bulletins
  754.           1, 3, & 4. You UDBS.CFG file would contain the following 3 lines:
  755.  
  756.              Bulletin1=1
  757.              Bulletin2=3
  758.              Bulletin3=4
  759.  
  760.           In DATABASE.DAT there are 5 different locations in the file, this
  761.           is what the value of 'x' refers to. Each location is stored as a
  762.           0 or 1 (NO or YES). Once a users bulletin location is set to a 1
  763.           (Yes), it stays that way. What this means is that once you commit
  764.           a bulletin location to a specific bulletin number (Lets say you
  765.           have Bulletin1=5), you can not change it to monitor a different
  766.           bulletin (say 6). No harm will occur, but incorrect information
  767.           will be in file. All of the locations that were set to 'yes' when
  768.           you were monitoring bulletin 5 are still set. Running a report at
  769.           this time would show someone had read bulletin 6 when in fact
  770.           they really didn't. The only way to switch to another bulletin
  771.           number is to first reset the bulletin flag you wish to reuse to a
  772.           'No' state. See the file maintenance function "Reset Bulletin
  773.           Flag" for more information.
  774.  
  775.      VERSION=
  776.  
  777.           This parameter tells the UDBS programs which version of PCBoard
  778.           files you are currently working with. It adjusts the programs to
  779.           use the proper USERS file record length and to use correct
  780.           callers log format. Setting this parameter incorrectly will cause
  781.           all sorts of failures. This is probably the most confusing of the
  782.           configuration settings since support for all PCBoard versions
  783.           from 10+ has been included. The proper settings are:
  784.  
  785.              VERSION=10
  786.  
  787.           This sets the analyzer to expect callers logs in the format that
  788.           was used with version 10. You cannot perform any user file func-
  789.           tions while Version=10. Support was not included in UDBS for
  790.           version 10 users files.
  791.  
  792.              For Version 11
  793.  
  794.           If you are running with version 11 (or processing old version 11
  795.           log files) you MUST remove this line from the configuration file.
  796.           As with version 10, NO Users file support is available for
  797.           version 11.
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.      UDBS Version 5.41                                              Page 14
  805.  
  806.  
  807.  
  808.  
  809.  
  810.              VERSION=12
  811.  
  812.           This sets all programs to use the new USERS file record length of
  813.           256 bytes per record. It also adjusts Useact.Exe to read the
  814.           version 12 callers log format.
  815.  
  816.              VERSION=14
  817.  
  818.           This sets all programs to expect version 14 files formats.
  819.  
  820.  
  821.           Important: You can NOT mix version 10, 11, 12, or 14 callers log
  822.                      files into a single file. If for example you are
  823.                      running version 14 and wish to process a version 11
  824.                      log, you MUST NOT reference the USERS file. With the
  825.                      VERSION= line removed, the program attempts to access
  826.                      the USERS file with a record length on 152 bytes
  827.                      (which would cause odd results since the v14 Users
  828.                      file record length is 400 bytes). In other words, when
  829.                      processing logs from a different version than the one
  830.                      you currently use, remove the USERS= configuration
  831.                      line to stop users file access.
  832.  
  833.      SINGLENODE
  834.  
  835.           Used in conjunction with VERSION=12 and VERSION=14. This signals
  836.           Useact.Exe that the log it is reading was generated by a single
  837.           node system. By single node I mean the /S and /D versions of
  838.           PCBoard. You will know if you have left this option out of your
  839.           config file if the first three letters of every users name are
  840.           missing.
  841.  
  842.           It has recently come to my attention that the /En versions of
  843.           PCBoard can also generate a "Singlenode" type of log if they are
  844.           told that they are not running on a network. So the above
  845.           statement may not be true in all cases. If in doubt check your
  846.           log to see if the node number is included on the first line of
  847.           each callers record (Refer to the examples below). If the node
  848.           number is missing, this is a "Singlenode" type of log and you
  849.           will need this parameter.
  850.  
  851.           Examples:
  852.                                  Node Number
  853.           Multi-node Log      
  854.           03-04-89 (14:30) (1) JEFF SUMBERG (2400) (N) RINGWOOD, NJ     
  855.  
  856.           Single node Log
  857.           04-04-89 (10:52)  JEFF SUMBERG (2400) (N) MOONACHIE, NJ       
  858.  
  859.  
  860.  
  861.  
  862.  
  863.      UDBS Version 5.41                                              Page 15
  864.  
  865.  
  866.  
  867.  
  868.  
  869.      LOG=\Path\Filename
  870.  
  871.           This parameter enables Useact's logging capability. When
  872.           specified, Useact will add lines to the end of the file you
  873.           specify. This file can be the callers log (the recommended output
  874.           file), or a file devoted specifically to watching Useact's
  875.           operation. The entries written to this log are 64 characters in
  876.           length, as is required if the callers log is the specified output
  877.           file. A sample of my callers log showing the log entries is
  878.           included below:
  879.  
  880.                 Minutes Used: 5                                          
  881.           11-27-88 (11:17)  ANY CALLER Off Abnormally                      
  882.           ************************************************************** 
  883.                 Scheduled Event ran at 15:47                             
  884.           ************************************************************** 
  885.                 USEACT v 5.32b: Started at 04:32:10 on 03-17-1991        
  886.                 Processing log file: EXTRACT.2                           
  887.                 Processed 18 calls from 12 users.                        
  888.                 There were 8 D/L's, and 2 U/L's during this period.      
  889.                 Processing completed normally at 04:32:59                
  890.           ************************************************************** 
  891.           11-27-88 (16:12)  NEXT CALLER (2400) (N) MOONACHIE, NJ           
  892.  
  893.           If Useact encounters any errors that cause it to end abnormally,
  894.           they will be reported in the log.
  895.  
  896.      EVENT
  897.  
  898.           This parameter tells Useact that you are running it in unattended
  899.           batch mode (such as Event.Sys). If an 'illegal function' error
  900.           should occur from a bad or unrecognized line, Useact will
  901.           automatically skip the line (writing it to the log if specified)
  902.           and continue, rather than displaying the prompt to continue or
  903.           terminate. This way if an error does occur, your system will not
  904.           be 'hung up' waiting for you to answer the prompt at 3am!. (see
  905.           Running Useact as an event).
  906.  
  907.      REPORT=
  908.  
  909.           This parameter instructs Useact to write the cumulative report
  910.           screen to a file. This file can be used as a bulletin if you
  911.           wish. If you have ever seen the cumulative report screen at the
  912.           end of Useact, this is a duplicate of that screen in a file.
  913.  
  914.      COLOR=NO
  915.  
  916.           If you are using a color system, and you prefer the Black & White
  917.           appearance of previous versions, this will force the programs to
  918.           stay in B/W mode.
  919.  
  920.      DOS PATH
  921.  
  922.      UDBS Version 5.41                                              Page 16
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.           As stated earlier, the configuration file UDBS.CFG is expected to
  930.           be in the current directory when the programs are run. The only
  931.           exception to this rule is with the Query program (Query.Exe and
  932.           indirectly Modify.Exe). Query may be run from any directory on
  933.           your system as long as the configuration file can be found in
  934.           your Path statement. When query is first run, it first checks the
  935.           current directory to see if the configuration file is there. If
  936.           not, it then checks every directory in your path in an attempt to
  937.           locate it. If it is found, program operation continues as ex-
  938.           pected. If it cannot be located an error message is issued. As an
  939.           example, say you keep all UDBS related programs in a subdirectory
  940.           called UDBS. Your Path statement might look like this:
  941.  
  942.              PATH=C:\;D:\EDIT;C:\UDBS;C:\PCB;D:\UTILITY ....
  943.  
  944.           If you were to shell out from PCBoard to check on a user, you
  945.           would be in the \PCB directory. It would no longer be necessary
  946.           to switch to the \UDBS directory to run the Query program. First
  947.           the path would direct DOS to the executable files. Then the Query
  948.           program would locate the configuration file when it searched the
  949.           path.
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.      UDBS Version 5.41                                              Page 17
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                          Text and Language Configuration
  988.  
  989.      Beginning with release 14 of PCBoard, the sysop has been given the
  990.      ability to customize their system PCBTEXT file with a program called
  991.      MKPCBTXT. In the process of making a system more friendly it also
  992.      called a problem because the standard text entries written to the
  993.      callers log changed as well, causing loss of text matches and improper
  994.      counts. Another problem was mixed language systems. Every time a
  995.      language is changed, that section of the callers log is written in
  996.      another language. Since this program was written for english callers
  997.      logs, it was as if these sections didn't even exist. 
  998.  
  999.      Useact has the ability to be configured by the sysop to recognize
  1000.      custom changes to the callers log AND callers logs in multiple mixed
  1001.      languages. When Useact begins it reads in one or more text files
  1002.      containing the match strings for the particular language(s) you are
  1003.      using. Then when a line of text is analyzed, it is checked for a match
  1004.      in each respective language. Each language file contains 31 lines of
  1005.      standard unformatted ASCII text, and is created with a text editor. A
  1006.      standard English file is included containing all the standard PCBTEXT
  1007.      entries Useact searches for.
  1008.  
  1009.      The following parameters control language configuration:
  1010.  
  1011.      Languages=n
  1012.  
  1013.           This parameter tells Useact the number of languages that will be
  1014.           used. It controls the number of language files to read, and the
  1015.           number of comparisons to check each line against. This parameter
  1016.           must be specified, and must be at least one (1).
  1017.  
  1018.      LanguageX=\path\Language_Filename
  1019.  
  1020.           Depending on the number of languages you specified in the
  1021.           previous parameter, you will have one or more of these
  1022.           parameters. The 'X' specifies the number of the language file.
  1023.           The parameter specified is the name of the file containing the
  1024.           language text. The text most often used in the log should be the
  1025.           first file specified (Language1=). The second most used would be
  1026.           number two (Language2=), and so on. If this format is not
  1027.           followed, the program will work correctly, but text scanning will
  1028.           take longer than necessary. A typical 3 language configuration
  1029.           might look like this:
  1030.  
  1031.           Languages=3
  1032.           Language1=English.Udb
  1033.           Language2=French.Udb
  1034.           Language3=Spanish.Udb
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.      UDBS Version 5.41                                              Page 18
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.                               Language File Format
  1047.  
  1048.      References will be made to the text file ENGLISH.UDB. Please refer to
  1049.      that file during this section. 
  1050.  
  1051.      This language text file(s) contain 31 lines. The order of the lines is
  1052.      fixed, by this I mean that "Operator Paged" (or its equivalent) MUST
  1053.      be the sixth line in every file. The character (~) is used as a
  1054.      comment marker. This character is used as a substitution character by
  1055.      PCBoard to tack additional text onto the line. When (~) is read by
  1056.      Useact all text from that point to the end of the line is stripped
  1057.      off. Any spaces preceding the (~) are also stripped off. Most of the
  1058.      lines in this file will work with all versions of PCBoard callers
  1059.      logs, except where indicated. Some text scans from early versions of
  1060.      PCBoard (10 & 11) are still hard coded into Useact. You may have to
  1061.      change some lines in this file to process version 12 logs properly.
  1062.      The numbers indicated inside the parenthesis is the record number from
  1063.      PCBTEXT that this line corresponds to (The numbers are from version
  1064.      14.x PCBTEXT).
  1065.  
  1066.      Several lines must be modified by you in order to be properly matched,
  1067.      or follow a specified format to work correctly. These lines have
  1068.      already been modified in the supplied english text file, but you
  1069.      should make special note of them:
  1070.  
  1071.      Message Left: Main Board
  1072.  
  1073.           This line exists in PCBTEXT as "Message Left:~". If you wish to
  1074.           count ALL messages left to ANY conference, you can leave the line
  1075.           like this. If you wish to count Main Board messages only (which
  1076.           is what this program only did in prior versions), you must add
  1077.           "Main Board" to the line (as shown). You can add whatever
  1078.           conference you wish. Just follow the format as written to the
  1079.           log.
  1080.  
  1081.      Comment Left: Main Board
  1082.  
  1083.           Same as above
  1084.  
  1085.      Bulletin Left: Main Board
  1086.  
  1087.           Same as above. Decide which bulletins read are the ones you want
  1088.           checked. You MUST include the conference name up until (but not
  1089.           including) the # sign or this scan will fail. "Main Board" has
  1090.           already been added since this is what has always been scanned for
  1091.           in prior versions.
  1092.  
  1093.      Main Board Questionnaire (n) Info. Saved
  1094.  
  1095.           PCBTEXT contains the line "Questionnaire ( ) Info. Saved".
  1096.           PCBoard then adds the number, and the conference where the
  1097.           questionnaire was answered. You must supply the finished line in
  1098.  
  1099.      UDBS Version 5.41                                              Page 19
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.           the text file. You can scan for any number, and any conference,
  1106.           since you're supplying the line to scan for. This shows up as the
  1107.           MBQ date on the Query screen.
  1108.  
  1109.      Minutes Used:
  1110.  
  1111.           The colon (:) is required on the text line. It is used for
  1112.           positioning to find the actual time. If you change the line, it
  1113.           must end in a colon. "You have been on for:" is legal since it
  1114.           ends in a colon.
  1115.  
  1116.      ZIP view executed on file
  1117.  
  1118.           Notice I have left the "ZIP" (or "ARC", "PAK") off this line in
  1119.           the supplied file. This makes it catch all compressed view
  1120.           commands regardless of the method you use.
  1121.  
  1122.      Most lines (except the ones noted above) can be used as they exist in
  1123.      PCBTEXT. Be sure if you make any changes to PCBTEXT that you copy all
  1124.      your custom changes to the UDBS language file(s). 
  1125.  
  1126.  
  1127.                                Text Matching Rules
  1128.  
  1129.      Each line in the language text file is associated with one of the
  1130.      count fields you see in the Query program. Placing the wrong text on
  1131.      the wrong line will cause the wrong field to increment. You must
  1132.      follow the order shown in the English.Udb file. Every line in the
  1133.      callers log file is checked for a match against every entry the
  1134.      language file(s).
  1135.      You can use as little, or as much text in the scan lines as you wish,
  1136.      as long as what you use is unique from some other log entry. For
  1137.      example:
  1138.  
  1139.           In the language file, the line "Access Denied - Real Names Only
  1140.           Allowed!" will cause a match and increment the trashcan field.
  1141.           However placing "Real Names Only" in the language file will cause
  1142.           the same to occur since it matches part of the log entry.
  1143.  
  1144.           But, if you used "DOOR" instead of "OPENED DOOR" in the language
  1145.           file, you would match on other log entries besides "opened door"
  1146.           (all lines containing the word "DOOR"). This is incorrect and not
  1147.           what you want to do.
  1148.  
  1149.      This method gives the Sysop full flexibility for text matching. With a
  1150.      little caution in setup, anything should be detectable.
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.      UDBS Version 5.41                                              Page 20
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.      The list that follows shows which configuration parameters are used by
  1165.      each program:
  1166.  
  1167.      Useact:
  1168.  
  1169.              Input=          Output=         Files=          New=
  1170.              Update=                         BulletinX=      Report=
  1171.              Newadditions=   Users=          Version=        Event
  1172.              UseactBackup=   PCBndx=         Languages=      LanguageX=
  1173.  
  1174.      Query/Modify:
  1175.  
  1176.              Files=          Users=          BulletinX=      Version=
  1177.              PCBndx=         PurifyBackup=   Color=
  1178.           
  1179.      Sync:
  1180.  
  1181.              Files=          Users=          Version=        PCBndx=
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.      UDBS Version 5.41                                              Page 21
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.                            Program Operation - Useact
  1224.  
  1225.      Useact essentially runs without operator intervention. Once started,
  1226.      it runs until completion (or an error is detected). During operation
  1227.      several information displays are constantly updated. These are all
  1228.      self explanatory, with perhaps the exception of "Storage Available".
  1229.      This is the amount of free string space that Useact places user names,
  1230.      File names, message numbers, etc. into. If your callers log is larger
  1231.      than Useact can process in one cycle, it will automatically go to the
  1232.      database update phase (if enabled) and generate a report to the output
  1233.      file named in the Output= parameter (if enabled). Useact will then
  1234.      continue with the callers log at the point where it left off. This
  1235.      cycle will be repeated as many times as necessary to complete the log.
  1236.      When Useact processes the log in sections, subsequent reports (if
  1237.      enabled) are output as CONTINUE.n, where n is the section number. As
  1238.      an example, if it takes Useact three cycles to complete a large log
  1239.      file and the Output= parameter specified a filename of 'log' then you
  1240.      would have the following report files: Log, Continue.1, and Contin-
  1241.      ue.2. If Useact finishes the log in one cycle, a cumulative total of
  1242.      all monitored system activity is displayed on your screen (The period
  1243.      total). This information is not displayed if multiple cycles are
  1244.      required to process a log. In any event, this information is always
  1245.      written at the beginning of the report(s).
  1246.  
  1247.                            Running Useact In Event.Sys
  1248.  
  1249.      Only the calls from the past 24 hours can be run through Useact
  1250.      otherwise a duplication of information will occur. Appendix B (The
  1251.      Newcalls Utility) and Appendix C (Setup for Multi-Node Systems)
  1252.      explain how to properly set up your event operations. The Newcalls
  1253.      program is a provided utility that marks the last place in the callers
  1254.      log where the previous event occurred, and extracts to a separate file
  1255.      all calls since then. Useact then processes the entries in this
  1256.      extract file. This way only the log entries since your last event are
  1257.      processed (be it daily, twice a day, or even weekly).
  1258.  
  1259.                             Error Handling In Useact
  1260.  
  1261.      If an error is encountered during processing in Useact, a diagnostic
  1262.      message will appear at the bottom of the screen. This message will
  1263.      give you information about the actual error and any remedial steps you
  1264.      can take to correct it. One error in particular is 'Illegal Function
  1265.      Call'. This can occur from several types of errors within the callers
  1266.      log that can be caused by PCBoard itself (Such as the system freezing
  1267.      and not correcting the log). If this occurs, the line containing the
  1268.      error will be displayed and you will be given the option of ignoring
  1269.      it and continuing or terminating processing so that you can edit this
  1270.      in the log. The choice is yours. (This is disabled if EVENT is
  1271.      active).
  1272.  
  1273.  
  1274.  
  1275.  
  1276.      UDBS Version 5.41                                              Page 22
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.                            Useact's Command line mode
  1284.  
  1285.      When I was writing Useact.Exe I added the ability to enter configura-
  1286.      tion parameters on the command line when the program was started. This
  1287.      way I didn't have to change the UDBS.CFG file each time to test some-
  1288.      thing. I have left this in the final program since it does offer some
  1289.      flexibility in operation. Useact will accept any of the configuration
  1290.      parameters it normally uses, with the following rules:
  1291.  
  1292.              1) The UDBS.CFG file still must exist
  1293.  
  1294.              2) The Config file is read first, then the command line
  1295.                 parameters.
  1296.  
  1297.              3) The command line parameters then supersede any parameters
  1298.                 found in the Config file.
  1299.  
  1300.              4) If the parameter doesn't exist in the Config file then
  1301.                 it is set from the command line
  1302.  
  1303.      As a quick example, assume your UDBS.CFG file had the following lines:
  1304.  
  1305.              Input=\Main\Caller
  1306.              Output=\Reports\Log
  1307.              Update=Yes
  1308.  
  1309.      Assume you wish to generate a report from an older callers log that is
  1310.      on a floppy disk. Normally you would have to edit UDBS.CFG to use the
  1311.      floppy drive, and turn off the updates. All you do is this from the
  1312.      command line:
  1313.  
  1314.      C>USEACT Input=A:filename Update=No
  1315.  
  1316.      As you can see, update, which is first read as 'Yes' will be changed
  1317.      to 'No'. Input, which was '\Main\Caller' will become 'A:Filename'.
  1318.      Parameters must be specified exactly the same way they are in the
  1319.      Config, I.E. no space before or after the equal sign. You must however
  1320.      separate each parameter with at least one space.
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.      UDBS Version 5.41                                              Page 23
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.                             Program Operation - Query
  1342.  
  1343.      The Query program allows you view the information stored in the
  1344.      database in a variety of ways. This program is totally menu driven
  1345.      with pop-up windows to guide you through the different search modes.
  1346.  
  1347.      A selection may be activated in one of two ways. Note the key letter
  1348.      at the beginning of each line and simply press that letter on your
  1349.      keyboard, the selection will execute immediately, or you can select
  1350.      using the cursor keys, and press Return when the selection bar is over
  1351.      the item you want.
  1352.  
  1353.      With selections that require you to enter a user or file name, it is
  1354.      not necessary to type the entire name, you can just type the first few
  1355.      characters of the name. Names are stored in the index file and if an
  1356.      exact match is not found, a list of close matches (up to twenty) will
  1357.      be presented in a window. You can then choose the one you want from
  1358.      this list. If what you want is not displayed in the list you can hit
  1359.      the ESC key to abort the search. This is very helpful if you are
  1360.      unsure of the complete name or the spelling. You will find this
  1361.      feature extremely useful, convenient, and timesaving.
  1362.  
  1363.      Names are sorted into alphabetical order in the index files from left
  1364.      to right. Therefor, partial searches always start at character
  1365.      position one. You can't for example enter a partial last name and get
  1366.      a close match on that. Partial searches always go from left to right.
  1367.  
  1368.      User Statistics
  1369.  
  1370.           This brings up a users activity record. When you select this, a
  1371.           window appears asking for the users name. If you decide at this
  1372.           point that you do not want to view a record, press Return and you
  1373.           will be returned to the main menu screen.
  1374.  
  1375.           If the name you entered was found, the users record appears on
  1376.           the screen with all system activity shown. If the users name was
  1377.           not found or you entered a partial name, a list of close matches
  1378.           will be presented in a window. Also shown is the date when this
  1379.           record was last updated by Useact, the date of this users first
  1380.           call to the system (if known), and the date the user answered the
  1381.           main board questionnaire (MBQ). Press F1 to view files downloaded
  1382.           by this user, F2 to see uploaded files, or hit Return for the
  1383.           main menu screen.
  1384.  
  1385.      Users Who Never Download
  1386.      Users Who Never Upload
  1387.  
  1388.           Use this function to isolate users with no file activity. When
  1389.           selected you will first be prompted to enter a "times on the
  1390.           system" value. This is used to isolate even further the inactiv-
  1391.           ity of users. Example, perhaps 100 people never upload after
  1392.  
  1393.  
  1394.      UDBS Version 5.41                                              Page 24
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.           1 time on the system, but if you entered 75, then only users who
  1401.           didn't upload after being on for 75 calls would be shown.
  1402.  
  1403.           In addition, when selecting users who never upload, you will also
  1404.           be asked if you want to see the ones who download, but never
  1405.           upload (There is a difference). The list will show the download
  1406.           count along side the user name.
  1407.  
  1408.      File Transfers During a Specific Period
  1409.  
  1410.           Use this function to find the names of files transferred between
  1411.           a starting and ending date. When you choose this function, a
  1412.           window will appear asking you if you would like to see downloads
  1413.           or uploads. Another window will then appear asking you to choose
  1414.           a date period. You may enter specific start and end dates or
  1415.           choose a date period from the period totals list. The prompts
  1416.           after this choice are self explanatory. Depending on the date,
  1417.           range, and size of your files, this function might take a minute
  1418.           or two so don't get impatient.
  1419.  
  1420.      Users With Keyboard Timeout Disconnects
  1421.  
  1422.           They sign in, and walk away. they start a download, and don't
  1423.           come back. You know the type. They show up here.
  1424.  
  1425.      Users Disconnected For Daily Time Limit
  1426.  
  1427.           These are people who use every second you give them. You can use
  1428.           this to find the time hogs, or perhaps a good user who needs more
  1429.           time.
  1430.  
  1431.      Users That Downloaded A Specific File
  1432.      Who Uploaded A Specific File
  1433.  
  1434.           A window will appear asking for a filename. You may enter a
  1435.           partial filename (in which case the close match window will
  1436.           appear) or the entire filename if known. The User(s) that
  1437.           downloaded or uploaded this file and the date of the transfer are
  1438.           shown.
  1439.  
  1440.           Press F1 to view a user record, a Window will appear asking for a
  1441.           name. Enter a user name (or hit Return to go back to the main
  1442.           menu). The users record will be displayed, and the function keys
  1443.           associated with that selection become active.
  1444.  
  1445.      All Files Downloaded By A Specific User
  1446.      All Files Uploaded By A Specific User
  1447.  
  1448.           A Window will appear asking for a user name. You may enter a
  1449.           partial name (in which case the close match window will appear)
  1450.           or the entire name if known. All files associated to this user
  1451.           are listed, along with the transfer date.
  1452.  
  1453.      UDBS Version 5.41                                              Page 25
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.           Press F1 to open this users record.
  1461.           Press F2 to view the opposite transfer direction.
  1462.  
  1463.      Display Period Totals
  1464.  
  1465.           Use this function to display the total amount of system usage
  1466.           from each update period. The display will show you the periods on
  1467.           file. The periods show in reverse order starting from the latest,
  1468.           and decreasing to the earliest.
  1469.  
  1470.           Press F1 to view a specific period, a window appears asking for a
  1471.           period number. Enter desired value. The display now shows the
  1472.           totals for that period.
  1473.  
  1474.           Press F2 to totalize a group of periods. A window appears asking
  1475.           for starting and ending periods. The display shows the total
  1476.           amount of activity during this group of periods. To display total
  1477.           system usage stored, enter "one" (1) for the starting period, and
  1478.           "zero" (0) for the ending period. All period totals will be
  1479.           summed and displayed.
  1480.  
  1481.      Users Exceeding DL/UL Ratio
  1482.  
  1483.           When selected, you will be asked for a ratio (xx:1). Enter the
  1484.           ratio you desire, or press Return to abort search. All users
  1485.           whose ratios are equal or greater will be displayed. The amount
  1486.           of downloads and uploads are shown, as well as the actual ratio
  1487.           (Rounded to the nearest count).
  1488.  
  1489.      Users That Never Left A Message
  1490.  
  1491.           These are users that never left a main board message. I suppose
  1492.           you could assume that these users have never read one also, but
  1493.           the log doesn't show this. A count of the times on the system is
  1494.           also shown to give you some idea of how active this user is on
  1495.           your system.
  1496.  
  1497.           Press F1 to open a user record. As before, enter a name, or just
  1498.           press enter.
  1499.  
  1500.           F2 and Return have different meanings depending on the size of
  1501.           the listing. Follow on screen prompts.
  1502.  
  1503.      Doors and Node Chat
  1504.  
  1505.           This function is used to help give you some idea of the activity
  1506.           for these two commands. A window will appear asking for the Doors
  1507.           mode or the Node Chat mode, after you make your selection,
  1508.           another window appears with a sub menu asking for your choice
  1509.           (Has used/Has not used). Users falling under the category are
  1510.  
  1511.  
  1512.      UDBS Version 5.41                                              Page 26
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.           shown, along with their number of times on the system. Follow on
  1519.           screen prompts for the proper use of the function keys
  1520.  
  1521.      Users With Security Violations
  1522.  
  1523.           Since there is more than one type of security violation, a window
  1524.           will appear with a sub menu when this function is selected. On
  1525.           each security display a count of the number of times the
  1526.           violation occurred is displayed next to the name.
  1527.  
  1528.                Selection Not Available
  1529.  
  1530.                      List all users that have selected a command that is
  1531.                      not allowed under their security level.
  1532.  
  1533.                Not Registered In Conference
  1534.  
  1535.                      Attempts to Join a conference that is private.
  1536.  
  1537.                Download Violation
  1538.  
  1539.                      Attempts to download password protected files, or
  1540.                      files with minimum security level higher than this
  1541.                      user.
  1542.  
  1543.                Access Denied - Password Fail
  1544.  
  1545.                      Disconnects for failed password during sign on
  1546.  
  1547.                      Access Denied - Trashcan
  1548.  
  1549.                      Trashcan name disconnects
  1550.  
  1551.                Access Denied - Locked Out
  1552.  
  1553.                      Locked out users, who tried anyway to get back on.
  1554.  
  1555.                Access Denied - Refused to Register
  1556.  
  1557.                      Callers denied access to the system after answering
  1558.                      'no' to the question "Do you wish to register?" (If
  1559.                      the Sysop has PCBsetup configured to give a level of
  1560.                      zero to these users). This does not apply if you set
  1561.                      NEWADDITIONS=NO since callers who refuse to register
  1562.                      are never added to the database.
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.      UDBS Version 5.41                                              Page 27
  1572.  
  1573.  
  1574.  
  1575.  
  1576.  
  1577.                All Of The Above
  1578.  
  1579.                      Displays users that have any of the above conditions,
  1580.                      the quantity of the violation(s) are displayed next to
  1581.                      the name as:
  1582.  
  1583.                      C: n  P: n  R: n  T: n  L: n  S: n  D: n
  1584.  
  1585.                      C = Conference, P = Password, R = Refuse to Reg.
  1586.                      T = Trashcan, L = Locked out, S = Selection N/A
  1587.                      D = Download Violation
  1588.  
  1589.      Baud Rates and Protocols
  1590.  
  1591.           A window appears with a sub menu when you select either of these
  1592.           functions. Select the item you wish from the sub menu. The users
  1593.           name, and a count of how many times the selection was used is
  1594.           displayed. Follow on screen prompts for the use of the function
  1595.           keys.
  1596.  
  1597.      Users That Page Sysop
  1598.  
  1599.           The users name, and the number of times they paged you are shown.
  1600.           The screen shows the meaning of the function keys.
  1601.  
  1602.      Show New Users On Specified Date
  1603.  
  1604.           Use this selection to scan the database and show all new callers
  1605.           for either a whole month or a specific day. A window will appear
  1606.           with a menu asking you which function you wish to use. Use
  1607.           leading zeros on the date if necessary as each digit must occupy
  1608.           two places. (EX: 01/08/87 or 05/12/87)
  1609.  
  1610.      Scan For User Name
  1611.  
  1612.           A window appears. Enter the part of the name you are looking for.
  1613.           This function is identical in operation to the name scan function
  1614.           of Sysop board command #7. Any name containing this part is
  1615.           displayed. As little as one character may be entered. Follow on
  1616.           screen prompts for the use of the function keys. This scan does
  1617.           not use the index file, it scans for text, not for index key
  1618.           order, and you can enter any part of the name.
  1619.  
  1620.      Generate Reports
  1621.  
  1622.           This mode allows you create reports using most of the functions
  1623.           discussed above. When entering this mode, a new menu will appear
  1624.           containing report functions. When a function is selected a window
  1625.           appears asking for the name of the output file. This is where the
  1626.           report will be written to, and can be any valid Dos filenames (or
  1627.           device). If it is desired to direct output to the printer, simply
  1628.           press Enter. Its is assumed that the printer is device LPT1.
  1629.  
  1630.      UDBS Version 5.41                                              Page 28
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.                            File Maintenance Functions
  1637.  
  1638.      When you select the file maintenance functions, a second module will
  1639.      be loaded from disk (Modify.Exe). At this time, all the database files
  1640.      are locked (not PCBoard specific files, these are always shared). This
  1641.      is done to prevent other UDBS programs accessing them while you
  1642.      perform any maintenance function. If a UDBS door happens to be running
  1643.      at this time, you will not be granted access to the files and will be
  1644.      returned to the Query module. Since the door has a four minute limit,
  1645.      you can try again in a few moments. After this module is loaded and
  1646.      the files successfully locked, a window will appear with the following
  1647.      functions:
  1648.  
  1649.      Delete User
  1650.  
  1651.           A window will appear asking for a user name (Partial names are
  1652.           accepted and close matches will be shown). The users record will
  1653.           then be displayed, press Return to delete the record, or Escape
  1654.           to abort the delete operation. Once deleted, the record will no
  1655.           longer appear in any query operation (except undelete), and the
  1656.           name will be considered new if found in the callers log during a
  1657.           database update. A deleted record may be restored unless the
  1658.           files have been purified, or the name has been added again by
  1659.           another update.
  1660.  
  1661.      Delete If Not In User File
  1662.  
  1663.           This function allows you to remove users from the database if
  1664.           they don't exist in your PCBoard users file. This selection can
  1665.           be run two ways, and a window will appear with your choices. 1)
  1666.           It will stop and show you each users record before actually
  1667.           deleting it (Giving you the opportunity to skip deletions), or 2)
  1668.           Delete immediately without acknowledgement. All deleted records
  1669.           can be undeleted before the files are purified. You cannot use
  1670.           this function if you are running version 10 of PCBoard, see the
  1671.           note under the VERSION=10 parameter.
  1672.  
  1673.      Purify Files
  1674.  
  1675.           When a user record is deleted, it is really only marked as
  1676.           deleted thereby allowing it to be restored. Purify reads all the
  1677.           data files and physically removes deleted records. Before purify
  1678.           starts, it creates backup copies of the database files in the
  1679.           unlikely event a system failure occurs.
  1680.  
  1681.           Unlike the previous versions, a Purify now takes much less time
  1682.           to perform. This is due to the fact that the data files no longer
  1683.           need to be packed (a method in which a record is removed by
  1684.           shifting all records above it down by one and renumbering all
  1685.           references that were shifted). A record is now removed by marking
  1686.           it as free, in effect creating a 'hole' in the file. When a new
  1687.           record is added these holes are used first before any records are
  1688.  
  1689.      UDBS Version 5.41                                              Page 29
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.           physically added to the file. Therefore certain files will never
  1696.           get smaller after a Purify is finished but will remain the same
  1697.           size until all the empty records (holes) are filled. The only
  1698.           data files that are still packed are the files with the .XRF
  1699.           extension. This is so all file transfers stay in the proper date
  1700.           order. The amount of time required to pack both of these file has
  1701.           always been minimal, perhaps several minutes each.
  1702.  
  1703.           You can stop purify and start it again at a more convenient time
  1704.           if desired. If you wish to stop processing after purify has
  1705.           started, press the Space Bar. When the code gets to a point where
  1706.           it can break, you will be returned to the File Maintenance menu.
  1707.           PLEASE be patient as it may take a minute or so reach the end of
  1708.           a pass, so DON'T keep hitting the Space Bar. This is the only way
  1709.           to stop a purify in progress, otherwise PERMANENT file damage may
  1710.           result (If you reboot for instance).
  1711.  
  1712.           Before purifying the database, it is a good idea to check the
  1713.           undelete function to make sure that there aren't any users marked
  1714.           for deletion that you might want to keep. Once purified, deleted
  1715.           records are gone for good!
  1716.  
  1717.                                  ** IMPORTANT **
  1718.  
  1719.           Just a note to users running single node systems under a multi-
  1720.           tasking system. I have placed file locking code into the program,
  1721.           to prevent other programs (such as the doors) from accessing the
  1722.           files during purify, but this will not be active unless the SHARE
  1723.           program is loaded before your multi-tasking system is started. In
  1724.           general, if you don't use SHARE, then I strongly recommend that
  1725.           you run purify OFF-LINE (or disable the doors if you have them).
  1726.  
  1727.      Undelete User
  1728.  
  1729.           When a user record is deleted, a flag within that record is set
  1730.           to mark a deleted status. This function is used to clear this
  1731.           flag and restore a record to a normal condition. When you select
  1732.           this option, a list appears showing all deleted user names. Press
  1733.           F1 to select a name for undeletion (This name you must enter in
  1734.           its entirety, partial names are not accepted here). After you
  1735.           enter the user name, the database is checked to make sure that a
  1736.           current user by that name doesn't already exist (say you deleted
  1737.  
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.      UDBS Version 5.41                                              Page 30
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.           a user, and he called back). If it does exist, the undelete
  1755.           request is aborted to prevent duplicate records from being
  1756.           created, otherwise the username is restored.
  1757.  
  1758.      Add Download Credit
  1759.      Add Upload Credit
  1760.  
  1761.           Use this function to add file credits to a users record. Up to
  1762.           ten credits can be added at one time. Enter the filenames if
  1763.           known. If the filename is not known, press F1 and the name
  1764.           'Credit' will be used. The transfer date on reports will be shown
  1765.           as 'Credit' if a filename was used, and as a transfer with
  1766.           filename unknown if F1 (Credit) was used. Press Enter if no more
  1767.           names are to added. The users Up/Download counts are also
  1768.           adjusted.
  1769.  
  1770.      Delete Download Credit
  1771.      Delete Upload Credit
  1772.  
  1773.           Use this function to delete file credits from a users record.
  1774.           After the users name is entered, the screen will display the
  1775.           names of the files that the user has transferred. (The word
  1776.           'Credit' appears when the name of the transfer is not known). The
  1777.           file in the upper left corner will be highlighted. Use the cursor
  1778.           arrows keys to move the highlight. Select files for deletion by
  1779.           depressing F1. After a file has been selected, it blinks. A
  1780.           selected file may be un-selected by depressing F1 again. When all
  1781.           files you wish to delete have been selected, press F10, and those
  1782.           files will be deleted. The users Up/Download count will be
  1783.           adjusted. The transfer protocol counts will also be adjusted.
  1784.           Deleted credits cannot be undeleted, they must be reentered with
  1785.           the Add Credit function (above).
  1786.  
  1787.      Database Size Information
  1788.  
  1789.           This selection brings up a window showing you the number of used
  1790.           records (items stored) and the number of empty records (holes) in
  1791.           each file. Press any key to return to the main menu.
  1792.  
  1793.      Change User Name
  1794.  
  1795.           Use this function to change the name of a user record (for in-
  1796.           stance a handle being changed to a real name). Enter the name
  1797.           that you wish to change (partial names are accepted). The name
  1798.           will be displayed along with a prompt asking for the new name.
  1799.           The new name must be no longer than 25 characters, a gauge bar is
  1800.  
  1801.  
  1802.  
  1803.  
  1804.  
  1805.  
  1806.  
  1807.      UDBS Version 5.41                                              Page 31
  1808.  
  1809.  
  1810.  
  1811.  
  1812.  
  1813.           provided to help you judge the length. The database is then
  1814.           checked to see that the new name you have entered doesn't already
  1815.           exist. If it does, the change request aborts, otherwise the
  1816.           change is made and you are returned to the menu.
  1817.  
  1818.      Subscriptions
  1819.  
  1820.           Use this function to enter, change or check for subscription
  1821.           expirations. When selected, a window appears asking if you would
  1822.           like to check an expiration or enter/change a date. 
  1823.  
  1824.           If you choose "check" (A), you will be asked if you would like to
  1825.           use today's date as the basis for expiration. If you choose
  1826.           "yes", then all subscriptions that have or are expired are shown.
  1827.           If you answer "no" to this question, you will be asked to supply
  1828.           the number of days until expiration. Enter any value (from 1 to
  1829.           32000). All subscriptions having this many days or less are
  1830.           shown. You can use this to determine which subscriptions are
  1831.           about to expire.
  1832.  
  1833.           If you choose "Enter/Change" (B), a window will appear asking for
  1834.           a users name. After you enter the name (partial names accepted),
  1835.           the users subscription date will be shown (if one exists) and the
  1836.           number of days remaining until expiration. To enter a
  1837.           subscription date, supply the month at the prompt "Month? [C/R =
  1838.           no change or reset]" followed by the day and year. To leave the
  1839.           existing date or reset an existing subscription to "Non sub-
  1840.           scriber" status, press return at this point (you will then be
  1841.           asked if you wish to clear the date).
  1842.  
  1843.      Comments
  1844.  
  1845.           Use this function to add comments to a users record. You will be
  1846.           able to enter two comment lines to each users record if desired.
  1847.           The first comment line is visible to the user when they use the
  1848.           Query door. The second line is ONLY visible to you. When you
  1849.           select this function a window appears asking you if you would
  1850.           like to (A) enter/change/delete user comments, (B) scan for text
  1851.           in the comments file, or (C) delete all comments.
  1852.  
  1853.           If you choose (A), a window will appear asking for the users name
  1854.           (partial names are accepted). After the name is entered, one of
  1855.           two comment screen will appear. 1) If no comments have been
  1856.           entered for this user, you will get the "enter comments" screen.
  1857.           You may enter one or both comment lines at this time (you can
  1858.           enter line one, and leave line two blank, or visa-versa). If you
  1859.           do not wish to enter a comment to this user at this point, leave
  1860.           BOTH lines blank, and no comment will be added. 2) if comments
  1861.           already exist for this user you will get the "edit comments"
  1862.           screen. The current comment lines will be shown at the top of the
  1863.           screen, and the first comment line will be placed on the edit
  1864.           line. The available editing functions are listed at this time on
  1865.  
  1866.      UDBS Version 5.41                                              Page 32
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.           the screen so I won't explain them here. After you finish editing
  1873.           the first line and press enter then second comment will be placed
  1874.           on the edit line. Press enter when finished. If you wish to
  1875.           delete the comments for this user, press ESC to delete each
  1876.           comment line. If BOTH comment lines are NULL when you finish
  1877.           editing, the comment record will be deleted.
  1878.  
  1879.           If you choose (B) "Scan Comment File For Text", you will asked to
  1880.           supply the text to scan for. This is similar to the "scan for
  1881.           user name" function. The comment records containing any portion
  1882.           of the text you enter will be shown along with the user name they
  1883.           are associated with. You could for example find all your
  1884.           registered users, if for example you placed in one of the comment
  1885.           lines "registered" and then scanned for that word.
  1886.  
  1887.           If you choose (c) "Delete All Comments", you will be prompted to
  1888.           make sure this is what you really wish to do. If you answer yes,
  1889.           all comments for every user will be deleted. You cannot undo this
  1890.           operation once selected.
  1891.  
  1892.      Rebuild Index Files
  1893.  
  1894.           Over time, especially after periods of heavy additions and dele-
  1895.           tions to the index files, the keys may become "unbalanced". This
  1896.           results in a decline in access speed and can under rare
  1897.           conditions cause an improper lookup. There is no recommended
  1898.           interval I can offer to you for performing this function, however
  1899.           I would do it at least once every two months. If you begin to
  1900.           notice search times slowing down, this might help. If you purge
  1901.           users on a regular basis, and do alot of purifications, I would
  1902.           do this more often, say on a monthly basis. 
  1903.  
  1904.           This function deletes the existing index files and rebuilds the
  1905.           keys from scratch. What you may gain is a smaller index file
  1906.           since all of the deleted keys are gone. Three index files are
  1907.           rebuilt, One for the main database file, one for the download
  1908.           name file, and the last for the upload name file. As each file is
  1909.           being rebuilt, an on screen percentage indicator is constantly
  1910.           updated. You cannot stop this operation once you start it. The
  1911.           time it takes to rebuild depends on the size of your files. Make
  1912.           sure you keep accurate backups also! I cant say this enough.
  1913.  
  1914.      Reset Bulletin Flag
  1915.  
  1916.           As explained earlier, once you set a bulletin parameter (1-5) to
  1917.           monitor a particular bulletin (1-99), you can't use that
  1918.           parameter to monitor a new bulletin since many flags could
  1919.           already be set to a 'Yes' state. If you decide to change a
  1920.           bulletin slot (1-5) to monitor a different system bulletin you
  1921.           can use this function to reset each of the bulletin flags for all
  1922.           users back to a 'No' state. You can also use this function to
  1923.  
  1924.  
  1925.      UDBS Version 5.41                                              Page 33
  1926.  
  1927.  
  1928.  
  1929.  
  1930.  
  1931.           reset a bulletin flag on a single user, allowing you to monitor
  1932.           if that user has re-read a particular system bulletin.
  1933.  
  1934.           When you select this function you will be presented with a menu
  1935.           asking you which bulletin flag you wish to reset. After you
  1936.           select the flag, another menu will appear asking if you wish to
  1937.           delete all flags (Global), or a single user's flag. If you choose
  1938.           the Global option, all of the flags for this bulletin will be
  1939.           reset to 'no' state. If you choose single user, you will be
  1940.           prompted for a name. Enter the name, if the name if found, the
  1941.           bulletin flag will be reset. If the name is not found, a menu of
  1942.           close matches will be presented to you. Picking a name from this
  1943.           list resets the bulletin flag for that name.
  1944.  
  1945.      Merge Two Data Records
  1946.  
  1947.           This selection give you the ability to merge an older data record
  1948.           into a newer one. The typical use would be when a user name has
  1949.           changed and two data records for the same physical person exist.
  1950.  
  1951.           When you select this function, you will first be asked for the
  1952.           primary data record. This is the record you will be keeping. The
  1953.           data from the second record will be merged into this record. You
  1954.           may enter a full or partial name as with other functions. If a
  1955.           partial name is entered, you will be presented with a list of
  1956.           close matches. After you enter the primary record name, you will
  1957.           be asked to enter the merge record. Again you may enter a full or
  1958.           partial name. After both records have been selected, you will be
  1959.           asked to confirm the merge. The default answer to this question
  1960.           is No. After the merge take place, the second record is deleted.
  1961.           All numerical information is summed into the respective fields of
  1962.           the first record and the file transfers from the second record
  1963.           are added to the end of the list of the primary record.
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.      UDBS Version 5.41                                              Page 34
  1985.  
  1986.  
  1987.  
  1988.  
  1989.  
  1990.                                Problems & Support
  1991.  
  1992.      This program was written in my spare time as a hobby, this is not a
  1993.      full time business for me. I do take my programs seriously, so I will
  1994.      of course try my best to fix any problems you may turn up. However, I
  1995.      cannot fix what I cannot duplicate. If I cannot duplicate your
  1996.      situation, please be prepared to submit to me copies of your database
  1997.      files, callers log, or whatever else might be required (Once I needed
  1998.      someone's USERS file). I am not interested in the content of these
  1999.      files, only the condition causing the problem. If you cannot agree to
  2000.      this then the condition may have to go unsolved until either I come
  2001.      across it by chance, or another user finds it and cooperates. 
  2002.  
  2003.      How to reach me:
  2004.  
  2005.           On the SailBoard BBS (Wayne, NJ). The number is 1-201-831-8152.
  2006.           This is my home board. The UDBS conference is #4. Registered
  2007.           users also receive support via the system's USR Courier HST.
  2008.  
  2009.           At the address in the beginning of this manual.
  2010.  
  2011.      The UDBS conference (#4) on the SailBoard is set up as the dis-
  2012.      tribution area for all registered software. If you call with a problem
  2013.      report or leave it on the network, please leave the exact version
  2014.      number and name of the program in your message. It would also be
  2015.      helpful to provide the file size and time/date stamp. Try to be
  2016.      specific with your description of the problem. All programs are
  2017.      subject to change without notice. You should REGULARLY check the UDBS
  2018.      support conference on the SailBoard for news of periodic updates and
  2019.      fixes. I  DO MAKE periodic fixes especially to Useact to keep it in
  2020.      step with PCBoard. Most of these fixes are very important to keep
  2021.      Useact working properly with all the changes that are made to the log
  2022.      in PCBoard updates.
  2023.  
  2024.                                 Acknowledgements
  2025.  
  2026.      I would like to thank the following people for their help:
  2027.  
  2028.           Richard Jerothe, Sysop of the SailBoard (1-201-831-8152) for
  2029.           letting me help Sysop his board. Without this I never would of
  2030.           had access to the files necessary for the development of this
  2031.           program.
  2032.  
  2033.           To the BETA testers. These Sysops have been the utmost help in
  2034.           furthering the usefulness of these programs, as well as their
  2035.           comments, criticism, suggestions, and good ideas. They have all
  2036.           at one time or another provided help in testing this program.
  2037.           Their cooperation has been extraordinary. They run excellent
  2038.           systems, and you should give them a call.
  2039.  
  2040.                Gerhard Barth, of the Tamiami BBS (813-793-2392)
  2041.                Phil Gordemer, of Compu-Data (609-232-1245)
  2042.  
  2043.      UDBS Version 5.41                                              Page 35
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.                Jim Oxford, of Torii Station (405-733-7083)
  2050.                Andy Keeves, of The Executive Network (914-667-4567)
  2051.                Scott Pazur, of the Flea Market (201-446-1665)
  2052.                Mark Rapp, of the MicroSellar (201-239-1346)
  2053.                Gary Thurlow, of Genesis First State PCBoard (302-475-7598)
  2054.                     ...and others.
  2055.  
  2056.           To ALL the registered users, Thanks for your support, and most of
  2057.           all your confidence.
  2058.  
  2059.                                Disclaimer/Warranty
  2060.  
  2061.      Jeff Sumberg makes no warranty of any kind, express or implied,
  2062.      including without limitation, any warranties of merchantability and/or
  2063.      fitness for a particular purpose. Jeff Sumberg shall not be liable for
  2064.      any damages, whether direct, indirect, special or consequential
  2065.      arising from a failure of these programs to operate in the manner
  2066.      desired by the user. Jeff Sumberg shall not be liable for any damage
  2067.      to data or property which may be caused directly or indirectly by use
  2068.      of this program.
  2069.  
  2070.      IN NO EVENT WILL I, Jeff Sumberg, BE LIABLE TO YOU FOR ANY DAMAGES,
  2071.      INCLUDING, BUT NOT LIMITED TO, ANY LOST PROFITS, LOST SAVINGS OR OTHER
  2072.      INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF YOUR USE OR IN-
  2073.      ABILITY TO USE THE PROGRAM, OR FOR ANY CLAIM BY ANOTHER PARTY.
  2074.  
  2075.      I MAKE NO WARRANTY OR CLAIM THAT THESE PROGRAMS WILL FUNCTION ON EVERY
  2076.      CONCEIVABLE COMBINATION OF HARDWARE AND/OR SOFTWARE.
  2077.                      
  2078.                                    Trademarks
  2079.  
  2080.      DoubleDos is a registered trademark of SoftLogic Solutions Inc.
  2081.  
  2082.      Microsoft is a registered trademark of Microsoft Corporation.
  2083.  
  2084.      DESQview is a registered trademark of Quarterdeck Office Systems.
  2085.  
  2086.      PCBoard is a product of Clark Development Corporation.
  2087.  
  2088.      Taskview is a trademark of Sunny Hill Software.
  2089.  
  2090.  
  2091.  
  2092.  
  2093.  
  2094.  
  2095.  
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101.  
  2102.      UDBS Version 5.41                                              Page 36
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.                    Appendix A - Getting Your Database Started
  2109.  
  2110.      Getting started is relatively simple. The first thing you want to do
  2111.      is properly set up your configuration file. Take a look at the sample
  2112.      that came with the programs. Most sites can use the setting of the
  2113.      INPUT= and OUTPUT= parameters as is. If not, simply change the names.
  2114.      You can also add the MBQ=, BULLETINX=, USERS=, and NEWADDITIONS=
  2115.      parameters at this time if you wish. You may have to make adjustments
  2116.      to the supplied language file ENGLISH.UDB, check it's entries to see
  2117.      that they match your PCBTEXT entries. 
  2118.  
  2119.      If you have kept all or some of your back callers logs, the easiest
  2120.      way to get going is to use an indirect input file. First gather all
  2121.      your callers logs together on your hard drive in some convenient
  2122.      subdirectory. Second, using a text editor that creates pure ASCII
  2123.      files, create a file (For this example, we'll call it MYLOGS) with the
  2124.      name of each log file on a separate line. Then, in your UDBS.CFG file,
  2125.      set the INPUT= statement to INPUT=@MYLOGS, then run Useact. Useact
  2126.      will run until it processes all the log files found in MYLOGS.
  2127.  
  2128.      The first time you run Useact you will be asked if you wish to create
  2129.      the database files. Answer 'Yes'. You should now see the analyzer
  2130.      stepping through each call. When the end of the log is reached (or
  2131.      space runs low, whichever comes first), control will pass to the
  2132.      database functions. Here you will see names being added to the
  2133.      database along with the file transfers. When this section completes,
  2134.      Useact will either end, or continue with the next section of the log.
  2135.      When Useact finishes, you will then be able to try out Query.
  2136.  
  2137.      After Useact is finished, you can use the SYNC utility if you desire
  2138.      to set the downloads, uploads, times on, and subscription dates to
  2139.      correspond with your users file.  
  2140.  
  2141.      Please note that if you plan to process multiple callers logs with an
  2142.      indirect file, that you cannot mix logs from versions 10, 11, 12, or
  2143.      14. You must process them separately according to the instructions in
  2144.      the configuration section (see VERSION=).
  2145.  
  2146.      After you have performed this initial setup, you can proceed to setup
  2147.      your event operations. This is covered in the next two Appendices (B &
  2148.      C).
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.      UDBS Version 5.41                                              Page 37
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.                     Appendix B - The NewCalls Utility Program
  2168.  
  2169.      NewCalls.Exe is a utility program designed to make daily database
  2170.      updates simpler than they have been in the past. This program copies
  2171.      the newest section of the callers log to a separate 'extraction' file.
  2172.      This extracted section of the callers log is what is then run through
  2173.      the UDBS database update program 'Useact'. After NewCalls has ex-
  2174.      tracted the section from the callers log, it records the last record
  2175.      extracted from the log (in a control file). When NewCalls is run
  2176.      again, it knows immediately from this recorded record number where to
  2177.      start the new extraction. All new calls (NewCalls) are then extracted
  2178.      from this point till the end of the log file, then the new 'end point'
  2179.      is recorded. This process continues daily in your event, and your
  2180.      original callers log is not  touched. The extracted file is
  2181.      overwritten at the next run of NewCalls, and will never be larger than
  2182.      one days worth of calls (except for perhaps the first run of Newcalls,
  2183.      when the first end point is established). NewCalls contains logic to
  2184.      sense the fact that a new callers log has been created by testing to
  2185.      see if the point of extraction is greater than the number of records
  2186.      in the callers log. If the callers log is deleted, NewCalls resets
  2187.      automatically to record one, and starts over. If NewCalls senses that
  2188.      the log is the same size as the last run, no records are extracted,
  2189.      and NewCalls ends.
  2190.  
  2191.      This program uses the premise that the callers log is a fixed record
  2192.      length random access file. These records are 64 characters in length
  2193.      containing 62 significant characters (the logged data) followed by a
  2194.      Carriage Return and Line Feed (62 + CR/LF = 64). Therefore anything
  2195.      that writes to the log (including ALL third party programs) MUST
  2196.      maintain this system. All programs that I know of do, otherwise you
  2197.      would see problems when you do the Sysops command "1 V" to view the
  2198.      log in reverse order. If records were less or greater in length, lines
  2199.      would appear out of sync (split in the middle). The same goes for this
  2200.      program. If any records are more or less than 64 characters, then ALL
  2201.      lines after that point will be improperly extracted.
  2202.  
  2203.      It should be noted that if you create a callers log that is only 1 day
  2204.      in length (deleted at each event), then this program should not be
  2205.      used. This program is for Sysops that keep an ongoing daily log, and
  2206.      delete it at some random time (weekly, monthly, etc.).
  2207.  
  2208.      NewCalls is driven off the command line, it does not read or use the
  2209.      UDBS configuration file. NewCalls has the following format:
  2210.  
  2211.           NEWCALLS controlfile callerslog extractfile
  2212.  
  2213.      Before you can use NewCalls in your event, you must first initialize
  2214.      the control file. If you fail to do this step first, then NewCalls
  2215.      will 'hang' your event waiting for a response from you. Initialize
  2216.      your control file as follows:
  2217.  
  2218.           NEWCALLS Node.Rec x x
  2219.  
  2220.      UDBS Version 5.41                                              Page 38
  2221.  
  2222.  
  2223.  
  2224.  
  2225.  
  2226.  
  2227.      Notice that THREE parameters are supplied here also. In this case two
  2228.      'x' characters are used to fill the input and output file spaces, in
  2229.      actual use these would be valid file names. the control file name
  2230.      'Node.Rec' is arbitrary, and you can select ANY valid filename. Multi-
  2231.      node systems will generate one control file for each node (to record
  2232.      the last position of each callers log). This file is written in the
  2233.      current directory, which in most cases is your UDBS directory (but
  2234.      does not need to be). When NewCalls detects that no control file
  2235.      exists, it will prompt you to be sure that you want to initialize a
  2236.      new file with the name you specified. Answering 'Yes' to the prompt
  2237.      creates and initializes the control file. You are now ready to place
  2238.      NewCalls in your event.
  2239.  
  2240.      Add the call(s) to the NewCalls program to your event before you call
  2241.      Useact. For this example I'm assuming a standard single node PCBoard
  2242.      setup using the standard directories. The syntax would be:
  2243.  
  2244.           NEWCALLS Node.Rec \PCB\MAIN\CALLER EXTRACT
  2245.  
  2246.      In this example NewCalls will read the control file 'Node.Rec' and
  2247.      create an output file called EXTRACT. Again, the name EXTRACT is
  2248.      arbitrary and may be any name you choose, it can even be directed to
  2249.      another drive or directory. 
  2250.  
  2251.      So, as an example, your Event.Sys might look like this:
  2252.  
  2253.           .
  2254.           .
  2255.           .
  2256.           Newcalls Node.Rec \PCB\MAIN\CALLER EXTRACT
  2257.           Useact
  2258.           Sync /F        (Optional step, see Appendix C)
  2259.           .
  2260.           .
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.      UDBS Version 5.41                                              Page 39
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.                   Appendix C - Setup For Multiple Node Systems
  2286.  
  2287.      If you have not already read "Appendix B - The Newcalls Program",
  2288.      please go back and do it now. Newcalls is used for multiple node
  2289.      systems and an understanding of how Newcalls extracts sections from
  2290.      callers logs is necessary.
  2291.  
  2292.      If you run two or more nodes, you would create multiple control files.
  2293.      You could for example name the control files 'Node1.Rec', 'Node2.Rec',
  2294.      etc. However there are three methods to process the output from
  2295.      Newcalls.
  2296.  
  2297.      The first method uses one extract file, which is overwritten by the
  2298.      next run of Newcalls. For this method your event file would look like
  2299.      this:
  2300.  
  2301.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT
  2302.           Useact
  2303.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT
  2304.           Useact
  2305.  
  2306.      For method one, remember to set the INPUT= statement in your UDBS.CFG
  2307.      file to reflect the name of the file you are using as the extract
  2308.      file, which in this example is EXTRACT.
  2309.  
  2310.      The second method uses multiple extract files, and your event would
  2311.      contain:
  2312.  
  2313.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT.1
  2314.           Useact INPUT=EXTRACT.1
  2315.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT.2
  2316.           Useact INPUT=EXTRACT.2
  2317.  
  2318.      There is no real difference in operation for method one or two. Notice
  2319.      however the use of the INPUT= statement on Useact's command line to
  2320.      tell it the name of the input file. Both run Useact twice, and create
  2321.      two (or more) period total entries in the Master.Dat file, each one
  2322.      being the daily usage for each node. If you were using a LOG=
  2323.      statement these two methods would create a log entry for each Useact
  2324.      run with information on each extract file.
  2325.  
  2326.      The third method uses multiple extract files and an indirect file to
  2327.      supply the names of the extract files to Useact. For this method your
  2328.      event would contain:
  2329.  
  2330.           Newcalls Node1.Rec \PCB\MAIN\CALLER1 EXTRACT.1
  2331.           NewCalls Node2.Rec \PCB\MAIN\CALLER2 EXTRACT.2
  2332.           NewCalls Noden.Rec \PCB\MAIN\CALLERn EXTRACT.n
  2333.           Useact INPUT=@MYLOGS
  2334.  
  2335.      This method is probably the simplest of them all. In this method,
  2336.      Useact only runs once and would probably be the quickest of the three
  2337.  
  2338.      UDBS Version 5.41                                              Page 40
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.      methods. However this method only creates one period total in
  2345.      Master.Dat, which would be the total usage for all your nodes. If you
  2346.      were using a LOG= statement with this method, only one log entry would
  2347.      be created, which again would contain total usage for all nodes. Be
  2348.      sure you understand the usage of indirect files if you plan to use
  2349.      this method. Indirect input files are explained in detail on page 9.
  2350.  
  2351.      Other than the number of period totals generated in Master.Dat, all
  2352.      three methods generate the same amount of user information in the
  2353.      database.
  2354.  
  2355.      Choose the method that best suits your situation and PCBoard site.
  2356.  
  2357.  
  2358.  
  2359.  
  2360.  
  2361.  
  2362.  
  2363.  
  2364.  
  2365.  
  2366.  
  2367.  
  2368.  
  2369.  
  2370.  
  2371.  
  2372.  
  2373.  
  2374.  
  2375.  
  2376.  
  2377.  
  2378.  
  2379.  
  2380.  
  2381.  
  2382.  
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.      UDBS Version 5.41                                              Page 41
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.                           Appendix D - The Sync Utility
  2404.  
  2405.      This utility is used to set the upload, download, registration date,
  2406.      and times on system counts for a user to be the same as the values
  2407.      stored in the Users file. When a user is first added to the database,
  2408.      all counts start at zero. But this user may have been on your system
  2409.      numerous times in the past, and might have many file transfers. If you
  2410.      save your past callers logs you could initialize your database this
  2411.      way (This would be the best way). Otherwise you would then run this
  2412.      program to set this users record 'up to date' with his past activity.
  2413.      Of course the names of the past file transfers will be unknown, and
  2414.      the total time value off, but at least the transfer counts are
  2415.      accurate. The registration date found in the PCBoard users file will
  2416.      be copied into the UDBS files if it is set to something other than
  2417.      zero (if the UDBS file contains a date, and the USERS file date is
  2418.      zero, the UDBS file will also be reset to zero). This way you only
  2419.      need to enter registration or subscription dates in one place, and can
  2420.      still utilize the subscription functions of UDBS.
  2421.  
  2422.      This program can be run in three ways. The first two are interactive
  2423.      and is done from the command line. When you run the program in this
  2424.      way you will be given the choice to modify one user, or do the entire
  2425.      database.
  2426.  
  2427.      The third way is out of EVENT.SYS (batch mode), and this is probably
  2428.      the best way as it does the entire database daily (or whenever), and
  2429.      it does it without your intervention. To use the batch mode add the
  2430.      following line to EVENT.SYS (if you use automatic daily update as
  2431.      explained earlier, place this line after the update):
  2432.  
  2433.           SYNC /F
  2434.  
  2435.        Note:   You cannot use the SYNC program in you are running version
  2436.                10 of PCBoard because of the differences in the USERS file.
  2437.                See the note under the Version=10 parameter.
  2438.  
  2439.  
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.  
  2449.  
  2450.  
  2451.  
  2452.  
  2453.  
  2454.  
  2455.  
  2456.      UDBS Version 5.41                                              Page 42
  2457.  
  2458.  
  2459.  
  2460.  
  2461.  
  2462.                           Appendix E - Common Problems
  2463.  
  2464.      Here is a list of common problems people have encountered, and their
  2465.      typical solutions.
  2466.  
  2467.      Problem:  The first 3 characters of every user name are missing.
  2468.  
  2469.      Solution: You are using a single node version of PCBoard (ie: /S, /D,
  2470.                or /En version with no network) and you forgot to add the
  2471.                line "SINGLENODE" to your UDBS.CFG configuration file.
  2472.  
  2473.      Problem:  Useact Stops during the event, hangs the system up again
  2474.                with the error message "Illegal Function Call".
  2475.  
  2476.      Solution: Add the line "EVENT" to the UDBS.CFG file to instruct Useact
  2477.                to ignore the error and continue.
  2478.  
  2479.      Problem:  You want to delete all user comments.
  2480.  
  2481.      Solution: DO NOT delete the comments file (Comments.Dat). Use the
  2482.                "Delete All Comments" function located in the comments
  2483.                selection of the file maintenance menu.
  2484.  
  2485.      Problem:  Useact doest count certain items correctly, or at all.
  2486.  
  2487.      Solution: If you changed certain text lines that are written to the
  2488.                callers log with the MKPCBTXT program, Useact does not
  2489.                recognize then new line. Therefore its as if it never
  2490.                occurred in the log. My feeling is you shouldn't change
  2491.                standard responses. A file containing all scanned text is
  2492.                available on request.
  2493.  
  2494.      Problem:  I get a "Bad Record Number" error or an "Error #63" message.
  2495.  
  2496.      Solution: Your data files have become corrupted because they were not
  2497.                closed properly after being updated. There is NO cure for
  2498.                this condition except a BACKUP copy. If Useact, Modify, or
  2499.                Up/Downcred are interrupted/booted/power loss/crash/etc
  2500.                while updating files ASSUME the files are bad and use your
  2501.                current backup.
  2502.  
  2503.      Problem:  "I know somebody downloaded a certain file, I see it in the
  2504.                callers log. But when I go to function G in Query [Who
  2505.                Downloaded...] I see user names, but not the one I saw do
  2506.                the download. Why?"
  2507.  
  2508.      Solution: Because of a bug caused by a caller log format change around
  2509.                May/June 1990, Useact 5.25 parsed 12 character file names
  2510.                with an extra space (13 character). This awakened a dormant
  2511.                bug in the index library which caused Useact to create a new
  2512.                transfer record. However this new transfer record was not
  2513.                connected to the existing transfer records for that
  2514.  
  2515.      UDBS Version 5.41                                              Page 43
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.                filename, so you don't see them. This can be fixed with the
  2522.                REPAIRDL utility. NOTE: If the REPAIRDL utility is not
  2523.                within this ZIP file, please contact me for it.
  2524.  
  2525.      Problem:  "I cant get the INPUT= to work with multiple callers logs"
  2526.  
  2527.      Solution: If the file name specified on the INPUT= statement starts
  2528.                with an "@" (as in INPUT=@CALLS) it means that the file
  2529.                "CALLS" *NOT* "@CALLS" is used as an indirect input file. An
  2530.                example of this is your DIR.LST file in PCBoard. This is a
  2531.                file that contains the names of your DIR files (and paths).
  2532.                This is exactly how it works here. The file "CALLS" would
  2533.                contain the names and paths of your callers logs.
  2534.  
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.      UDBS Version 5.41                                              Page 44
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.                      Appendix F - What Registered Users Get
  2581.  
  2582.      Aside from getting full support, you also have the ability to suggest
  2583.      new additions to be implemented into UDBS. When you register your copy
  2584.      of the User Database System you will receive the following additional
  2585.      programs:
  2586.  
  2587.      QRYDOOR   This is the user inquiry door. This door allows the user to
  2588.                view their own personal system statistics. They may also
  2589.                view their download and upload transfer list. This is
  2590.                similar to function A in the Query program.
  2591.  
  2592.      UPLDOOR   This is the upload inquiry door. Users will be allowed to
  2593.                ask "who uploaded this file" to your system. They will be
  2594.                shown the name of the uploader, the date of the upload, and
  2595.                if any downloads (how many) have been made on the file. This
  2596.                program is similar to several competitors programs that use
  2597.                Download.Txt, except the Upldoor finds the information
  2598.                immediately from the database, it doesn't have to scan for
  2599.                it.
  2600.  
  2601.      DOWNCRED  Do you run a system that has download ratios? If so then
  2602.                this program is for you. Using this program you can offer
  2603.                ratio-free programs to your users. It could perhaps be your
  2604.                master file list, or some special file you want to offer to
  2605.                your users. This program runs in the event and credits the
  2606.                download automatically in both the UDBS and USERS files. The
  2607.                program can also be used to help keep your database free of
  2608.                junk such as Qwikmail downloads (*.QWK files). In this case
  2609.                Downcred will remove the file from UDBS but not credit the
  2610.                USERS file.
  2611.  
  2612.      UPCRED    Similar to Downcred. Primarily used to remove repetitive
  2613.                uploads of the same file from your database (Such as Qwik-
  2614.                mail *.REP files).
  2615.  
  2616.      CMTUTIL   This program copies the comment fields in your USERS file to
  2617.                the UDBS comment fields. This way any comments that your
  2618.                users enter (such as addresses, machine/modem type, etc) are
  2619.                viewable when a users record is viewed. The user can also
  2620.                see the public comment field when the Query door is run.
  2621.                This program runs during your event.
  2622.  
  2623.      Several other minor utilities are available to all users. These are
  2624.      posted on the Sailboard BBS. Other utilities are planned for the
  2625.      future.
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.      UDBS Version 5.41                                              Page 45
  2634.  
  2635.  
  2636.  
  2637.  
  2638.  
  2639.                                       Index
  2640.  
  2641.      Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2642.      Add Download Credit . . . . . . . . . . . . . . . . . . . . . . . . 31
  2643.      Add Upload Credit . . . . . . . . . . . . . . . . . . . . . . . . . 31
  2644.      All Files Downloaded By A Specific User . . . . . . . . . . . . . . 25
  2645.      All Files Uploaded By A Specific User . . . . . . . . . . . . . . . 25
  2646.      Alloy's PC/slave card . . . . . . . . . . . . . . . . . . . . . . .  7
  2647.      Backups
  2648.           Automatic  . . . . . . . . . . . . . . . . . . . . . . . . 11, 29
  2649.           Filenames Of . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2650.           Importance of  . . . . . . . . . . . . . . . . . . . . . . . .  8
  2651.           Inhibiting . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2652.      Baud Rates  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  2653.      BULLETINx=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2654.      Change User Name  . . . . . . . . . . . . . . . . . . . . . . . . . 31
  2655.      Command Line Mode . . . . . . . . . . . . . . . . . . . . . . . . . 23
  2656.      Comments  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
  2657.           Delete All Comments  . . . . . . . . . . . . . . . . . . . . . 33
  2658.           Enter/Change/Delete  . . . . . . . . . . . . . . . . . . . . . 32
  2659.           Scan For Text  . . . . . . . . . . . . . . . . . . . . . . . . 33
  2660.      COMMENTS.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2661.      Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . 43
  2662.      Config.Sys  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2663.      Configuration Parameters, Where Used  . . . . . . . . . . . . . . . 21
  2664.      Copying and Distribution  . . . . . . . . . . . . . . . . . . . . .  6
  2665.      Database Files, Location of . . . . . . . . . . . . . . . . . . . . 11
  2666.      Database Size Information . . . . . . . . . . . . . . . . . . . . . 31
  2667.      DATABASE.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2668.      Delete Download Credit  . . . . . . . . . . . . . . . . . . . . . . 31
  2669.      Delete If Not In User File  . . . . . . . . . . . . . . . . . . . . 29
  2670.      Delete Upload Credit  . . . . . . . . . . . . . . . . . . . . . . . 31
  2671.      Delete User . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2672.      DesqView  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 36
  2673.      Display New Users Only  . . . . . . . . . . . . . . . . . . . . . . 12
  2674.      Distribution Contents . . . . . . . . . . . . . . . . . . . . . . .  6
  2675.      Doors and Node Chat . . . . . . . . . . . . . . . . . . . . . . . . 26
  2676.      DoubleDos . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 36
  2677.      DOWNLOAD.NAM  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2678.      DOWNLOAD.XRF  . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2679.      Error Handling in Useact  . . . . . . . . . . . . . . . . . . . . . 22
  2680.      File Maintenance Functions  . . . . . . . . . . . . . . . . . . . . 29
  2681.      File Transfers During a Specific Period . . . . . . . . . . . . . . 25
  2682.      Filename.HDR  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2683.      Filename.IDX  . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2684.      FILES=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2685.      Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . 37
  2686.      Index File Names  . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2687.      Index File Structure  . . . . . . . . . . . . . . . . . . . . . . .  8
  2688.      Indirect Input FIles  . . . . . . . . . . . . . . . . . . . . . . .  9
  2689.      INPUT=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  9
  2690.      Language File Format  . . . . . . . . . . . . . . . . . . . . . . . 19
  2691.  
  2692.      UDBS Version 5.41                                              Page 46
  2693.  
  2694.  
  2695.  
  2696.  
  2697.  
  2698.      Languages=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  2699.      LanguageX=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  2700.      LOG=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  2701.      MASTER.DAT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2702.      MBQ=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2703.      Merge Two Data Records  . . . . . . . . . . . . . . . . . . . . . . 34
  2704.      Microsoft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2705.      Microsoft Windows . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2706.      MKPCBTXT  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  2707.      MODIFY.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 29
  2708.      Monitoring Bulletins Read . . . . . . . . . . . . . . . . . . . . . 13
  2709.      Network File Access . . . . . . . . . . . . . . . . . . . . . . 11, 12
  2710.      NEW=YES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2711.      NEWADDITIONS=NO . . . . . . . . . . . . . . . . . . . . . . 12, 13, 27
  2712.      NewCalls Utility Program  . . . . . . . . . . . . . . . . . . . . . 38
  2713.      OUTPUT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2714.      PATH Statement (DOS)  . . . . . . . . . . . . . . . . . . . . .  7, 16
  2715.      PCBNDX= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2716.      PCBoard
  2717.           Beta Releases  . . . . . . . . . . . . . . . . . . . . . . . .  8
  2718.           Bulletins  . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  2719.           Changes, To Callers Log  . . . . . . . . . . . . . . . . . . .  8
  2720.           Changes, To USERS File . . . . . . . . . . . . . . . . . . . . 12
  2721.           Event.Sys  . . . . . . . . . . . . . . . . . . . . . . . . 16, 22
  2722.           Multi-Node Systems, Setup  . . . . . . . . . . . . . . . . 40, 43
  2723.           Single Node Systems  . . . . . . . . . . . . . . . . . . . . . 15
  2724.           Trademark  . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2725.           USERS File, Record Length  . . . . . . . . . . . . . . . . . . 14
  2726.           USERS file, Where Its Used . . . . . . . . . . . . . . 12, 14, 29
  2727.      PCBTEXT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  2728.      Period Totals . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
  2729.      Preventing Database Additions . . . . . . . . . . . . . . . . . . . 13
  2730.      Problem Reports . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2731.      Protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  2732.      Purify  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11, 29
  2733.           Stopping . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
  2734.           What It Does . . . . . . . . . . . . . . . . . . . . . . . . . 29
  2735.      PURIFYBACKUP=NO . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2736.      QUERY.EXE . . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 24
  2737.      QuickBasic run-time library . . . . . . . . . . . . . . . . . . . .  7
  2738.      Rebuild Index Files . . . . . . . . . . . . . . . . . . . . . . . . 33
  2739.      Registration  . . . . . . . . . . . . . . . . . . . . . . . . . . .  5
  2740.      REPORT= . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
  2741.      Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
  2742.      Reset Bulletin Flag . . . . . . . . . . . . . . . . . . . . . . . . 33
  2743.      RESETBUL.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2744.      Restrictions  . . . . . . . . . . . . . . . . . . . . . . . . . . .  8
  2745.      SailBoard BBS . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2746.      Scan For User Name  . . . . . . . . . . . . . . . . . . . . . . . . 28
  2747.      Setup For Multiple Node Systems . . . . . . . . . . . . . . . . . . 40
  2748.      Show New Users On Specified Date  . . . . . . . . . . . . . . . . . 28
  2749.      SINGLENODE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
  2750.  
  2751.      UDBS Version 5.41                                              Page 47
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.      Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
  2758.      Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
  2759.      Sync Utility  . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
  2760.      SYNC.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2761.      System Requirements . . . . . . . . . . . . . . . . . . . . . . . .  7
  2762.      Taskview  . . . . . . . . . . . . . . . . . . . . . . . . . . .  7, 36
  2763.      Text Matching Rules . . . . . . . . . . . . . . . . . . . . . . . . 20
  2764.      Trademarks  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
  2765.      UDBS.CFG  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2766.      UDBS50.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . . . .  7
  2767.      Undelete User . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
  2768.      UPDATE=YES  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  2769.      UPLOAD.NAM  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2770.      UPLOAD.XRF  . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2771.      USEACT.EXE  . . . . . . . . . . . . . . . . . . . . . . . . . .  6, 22
  2772.      USEACTBACKUP=NO . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  2773.      User Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . 24
  2774.      Users Disconnected For Daily Time Limit . . . . . . . . . . . . . . 25
  2775.      Users Exceeding DL/UL Ratio . . . . . . . . . . . . . . . . . . . . 26
  2776.      Users That Downloaded A Specific File . . . . . . . . . . . . . . . 25
  2777.      Users That Never Left A Message . . . . . . . . . . . . . . . . . . 26
  2778.      Users That Page Sysop . . . . . . . . . . . . . . . . . . . . . . . 28
  2779.      Users Who Never Download  . . . . . . . . . . . . . . . . . . . . . 24
  2780.      Users Who Never Upload  . . . . . . . . . . . . . . . . . . . . . . 24
  2781.      Users With Keyboard Timeout Disconnects . . . . . . . . . . . . . . 25
  2782.      Users With Security Violations  . . . . . . . . . . . . . . . . . . 27
  2783.      USERS=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
  2784.      VERSION=  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
  2785.      What Isn't Supported  . . . . . . . . . . . . . . . . . . . . . . .  8
  2786.      What Registered Users Get . . . . . . . . . . . . . . . . . . . . . 45
  2787.      Who Uploaded A Specific File  . . . . . . . . . . . . . . . . . . . 25
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.  
  2799.  
  2800.  
  2801.  
  2802.  
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.  
  2809.  
  2810.      UDBS Version 5.41                                              Page 48